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ABSTRACT 



This thesis describes a set of APL programs which enable 
a student to learn A Programming Language (APL) by using it. 
The student needs to know only how to log on to the computer 
and enter a few simple comaands to begin the course. 

The basic unit of the TUTOR workspace is the text vari- 
able which describes the use of one of seventy-five built-in 
APL functions. This description is accessible by a HELP 
function without going through an entire lesson. Other 
functions conduct interactive guesti on-and-answer drill. A 
MENU function lists the units for student selection of a 
lesson or information on a symbol. The stuient can also go 
through a sequence of lessons in a o omputer-drivsn course. 

These programs were written on and for the IBM 3033 
installation at Naval Postgraduate School, using APL version 
4.0 for VM/CMS with IBM 3278 terminals. 
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I. B ACK GROPED 

A Programming Language (APL) is an interactive, inter- 
pretive computer language designed by Kenneth E. Iverscn at 
Harvard in 1962. Its advantages include the ease of manipu- 
lation of multi-dimensional arrays of numbers, the lack of 
rigorous input/output formatting, and the use of unique 
symbols to represent a wide variety of built-in functions. 
Unlike other high-level languages, there is no requirement 
to write and compile a strictly formatted program before 
execution. APL may be used in ’’desk calculator" mode, where 
a single line of input is accepted and evaluated, returning 
an immediate response. While it may take quite seme ^ ime 
for the user to master APL fully, the beginner can quickly 
jump in and start experimenting. 

The APL TUTOR was designed to enable the beginning APL 
student to gain some familiarity with the basic concepts of 
the language without going through a formal course. If 
consists of a set of APL programs which enable the student 
to enter simple commands and receive information, questions, 
and drill about the symbols and functions used in APL. 
Since at present no information on writing functions is 
included, it may be used as a supplement to the normal mode 
of teaching at NPS. 

Currently the APL student's resources at NPS consist of 
the instructor, other students, and texts such as those 
listed in the bibliography. There also exists a copyrighted 
IBM drill function, TEACH, found in the APLCOURS workspace 
in the public library of most APL installations. (At NPS, 
it can be accessed by entering ) LOAD 1 APLCOURS while in APL 
mode.) This function, and a sub-function, EASYDRILL, 
provide simple drill questions for calculator functions 



7 



selected by the student. This workspace does not, however, 
provide any information concerning the correct use cr syntax 
of any functions. 

The specific audience targeted is the first to third 
quarter NPS students in the Operations Analysis curriculum, 
who are currently taught APL in one-hour weekly labs as part 
of three probability and statistics courses. Many, if not 
most, of these students arrive at NPS from six weeks to six 
months before their first quarter. It would be to their 
advantage to get a 'head start' on learning APL, but there 
is no separate course in this language as there is in 
FORTRAN or PASCAL, for example. 

A basic requirement for the TUTDR, then, is that it be 
comprehensible to someone who has never seen APL before. In 
fact, the "desk calculator" functions should be understand- 
able to someone who has never even used a computer before. 
This means that some of the beginning lessens may seem too 
simplistic to the student who has some programming experi- 
ence. However, the mors advanced student can easily skim 
through this primary material and progress to the more 
sophisticated concepts. Intermediate mathematics including 
concepts of linear algebra is the only background informa- 
tion that is assumed. 
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II. USING A PL TUTOR 



The APL TUTOR workspace should be available in one of 
the public libraries at NPS . Instructions for loading and 
copying it are on the first page of Appendix A. If it is 
not available in the public libraries, it can be obtained 
from Professor R. S. Read upon request. 

The APL TUTOR workspace contains sixteen functions which 
administer the course. Their interrelationship is shewn in 
Figure B.l. In this diagram, the ovals indicate functions 
which are called by the student, while rectangles indicate 
functions which are called internally. The procedure of 
each function is outlined in Figures B.4 through B.21. 
Further information can be found in the comment lines of 
each program in Appendix 5, part B. 

The actual text of the course is contained in APL vari- 
ables which are displayed by the functions SHOW and RUN. 
The text of each variable can be found in Appendix B, part 
C.2. Also in Appendix B (part C.1) are several global vari- 
ables which are used in various programs. Host important of 
these is MAT, which provides information on each text vari- 
able, such as the symbol it pertains to, the function type 
(Monadic/Dyadic/Neither) , the type of arguments it takes 
(Numeric, char acter ( K) , Either, Boolean), the rank of the 
arguments permitted (Scalar, Vector, matrix(X), Any), and a 
sequential lesson number. The other major global variable 
is CUES, which consists of a number of questions that can be 
called upon by the ASK function. 

Before commencing the APL TUTOR course, the student 
needs to have, as a minimum, the instructions given on the 
first page of Appendix A. The other information the student 
will need is displayed by the TUTOR, and is also included in 
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Appendix A, which should be given to all students who will 
be using TUTOR. The variable HOW is displayed each and 
every time the workspace TUTOR is loaded by the student, ana 
can also be called up at any tins by entering HOW. The 
other variables in Appendix A are displayed by the START 
function. Most may be called up by the student at any time, 
as noted. 

Figure B.1 shows the variety of ways the student can 
access and use the information in TUTOR. The beginner 
enters START to get the basic background information needed 
to complete the course. START instructs the student to 
enter LESSON 100 to begin the course. After completing this 
lesson, the student merely has to enter LESSON NEXT to 
receive the instructional units in the order indicated in 
the variable MAT. 



The student who is enrolled in a course using APL may 
also follow the instructor's guidance concerning lessons to 
take. The student enters LESSON N Nil , where NNN is the 

lesson number assigned. A more advanced student car. explore 
or review earlier lessons by entering TEACH and then the 
symbol that he/she is interested in. 

The more advanced student may also be interested in the 
HELP function which displays information without asking 
guesticns or providing a drill. The student can enter HELP, 
followed by the appropriate symbol, or INFO NNN, where NNN 
is the same as the pertinent lesson number. These lesson 
numbers can be found by entering MENU and browsing the list 
displayed. MENU also repeats the instructions for using 
LESSON and INFO. 



Effort has been made to ensure that the programs will 
not terminate abnormally in response to a student input 
error. Every input is checked for validity before it is 
processed. For example, see the function DRILL, page 59, at 
lines 8 to 17. However, because it is not possible to check 
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for every possible input or combination of inputs, there may 
still be some way to cause an error. Instructions to the 
student in case of an error are included in the BASICS 
displayed by the START function. The student should have a 
hard copy of these instructions, as well. 

Any input by the student at a time when no input is 
called for will cause an abnormal termination. This is 
inherent in the APL interpreter and cannot be avoided by the 
programmer. However, all the student needs to dc in this 
case is restart by entering one of the elementary commands 
(HELP, TEACH, LESSON, etc.) 

A sample run is included at Appendix C. 



III. EXTENDING A PL TUTOR 

There ere many ways in which the A?L TUTOR car. be 
expanded to improve its usefulness. Lessons could be 
included on the many system commands and variables which are 
used in APL. Auxiliary lessons on groups of functions, s.g. 
logical functions, and their basis concepts could provide 
useful additional information. Lessons could be added to 
describe programming techniques, and amplifying lessons on 
applications could be provided. Probably any of the lessens 
could benefit from additional questions to be included in 
the ASK function. Also, the ASK function itself could be 
modified to permit mere complex questions and answers. 

Another type of improvement from the pedagogical point 
of view would be the inclusion of facilities for measuring 
and recording students' progress. The student could be 
tested after every lesson or group of lessons and the scores 
recorded for the instructors review. Or, the course could 
be designed to automatically review the student's weak areas 
and retest before going on. In any case, it might be bene- 
ficial to include lessons which review concepts covered by 
the course so far. 

A test and evaluation of the TUTOR would be extremely 
beneficial in comparing it to the current teaching methods. 
Students could be tested for their knowledge of APL and 
those who had used the TUTOR compared to those who had not. 
Furthermore, different versions of the TUTOR could be tested 
against each other. Several different texts could be used, 
cr versions with and without the drill functions. 

This could lead to a still more sophisticated modifica- 
tion of the course, in combination with programmed student 
testing. After an initial unit, the testing could be 
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designed to reveal what type of instruction, e.g. drill or 
no drill, works best for that individual student. Or, the 
student could simply be asked his or her preferences in 
terms of teaching techniques. Then the course would auto- 
matically tailor later lessons to the individual. 

All of these changes require someone skilled in APL to 
modify the current programs. These programs have beer, 
heavily documented by flow charts and co.mment lines 
(Appendix B) in order to make the task of modification 
easier. Also, specific instructions for certain types of 
modifications are included in the variable HOWMODS, Appendix 
B, part D. Any advanced student can personalize a copy of 
TUTOR with the help of these tips. For more substantial 
modifications such as those suggested above, the point of 
contact for the public version of TUTOR at NFS is Professor 
R. R. Pead. 
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APPENDIX A 

USER'S GUIDE TO APL TUTOR 



IF YOU HAVE NEVER EVER USED THE COMPUTER BEFORE, START HERE: 

1. Go to the Registration and Accounting Office inside 

Ingersoll rm. 141. Ask for a user number. You will 
need to tell them the password you wane to use. 

2. While veu are there, pick uo a copy of NPS Technical 

Note V 3 - 0 1 , "User's Guide to Vm/CMS at NPS." 

3. Follow the instructions an VM-0 1 for logging on and 

formatting your disk. If vour keyboard has little red 
symbols on it, you may continue with step 6 below. 
Otherwise, log off (see Vm- 01) and continue with step 4 
when you are ready. 

IF YOU HAVE FORMATTED YOUR DISK, START HERE: 

4. Find a free terminal (in Ingersoll room 141 or room 369) 
that has red symbols on the keyboard. 

5. Log on and enter your password. 

6. When you see a line beginning SMS..., Dress the ENTER 
key. 

7. When you see a line beginning R: ...» enter the letters 

APL. 

8. You* should see several lines appear ending with the line 
CLEAR WS. If you don't, stop nere and get help! 

9. New look at the bottom center of your screen, below the 

line. If you see the letters A?L, go on to the next 

step. If you don't, hold down the ALT key (next to the 

ENTER key) and press the large kev at the too right of 
the main keyboard which has ArL ON-OFF in red letters on 
the front. The letters APL should now appear at the 
bottom of your screen. This tells the terminal to use 
the red symbols when you upshift. To use the red 
symbols on the front of the keys, you must hold down the 
ALT key instead of the SHIFT key. 

10. IF THIS IS THE VERY FIRST TIME YOU ARE USING APL TUTOR, 
ENTER ) LOAD 5 TUTOR. (Remember to use the red paren- 
thesis, third row, far right, not the black parenthesis 
in the tOD row.) OR FOLLOW THE DIRECTIONS GIVEN BY YOUR 
INSTRUCTOR. If you have used TUTOR before, and you 
followed the directions in steps 12 and 13 below, just 
enter ) LOAD TUTOR. 

11. Now just follow the directions which appear on the 
screen. If no directions appear, and all you see is a 
line which says SAVED.. . and possibly a line which says 
WSSIZE..., enter HOW to see the directions. To be sure 
that the directions appear every time, enter START, and 
follow steps 12 and 13 when you finish your session. 

12. If this is the first time you have used TUTOR, enter 
) WSID TUTOR. 

13. When you are ready to quit for the day, enter )SAVE. 

14. when you see the time, date, and TUTOR, enter )OFF. 

This will log you off the computer completely. (For 
more advanced students: ) OFF HOLD will'return you to 

CMS.) 
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HOW 



YOU MAY USE THE AFL TUTOR IN THREE WAYS* 

(1) enter; help 

TO SELECT THE SYMBOLS THAT YOU WANT INFORMATION ABOUT, 

(2) enter; teach 

TO SELECT THE SYMBOLS THAT YOU WANT INFORMATION AND DRILL ON, 

(3) enter; menu 

TO SEE A LIST OF SYMBOLS AND TOPICS, 

IF YOU HAVE NEVER USED THE APL TUTOR BEFORE , ENTER* START 

TO SEE THESE INSTRUCTIONS AGAIN AT ANY TIME, ENTER* HOW 
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INTRO 



WELCOME TO THE APL TUTOR , 

THE PURPOSE OF THIS WORKSPACE IS TO INTRODUCE YOU TO 

1 A PROGRAMMING LANGUAGE 1 BY DESCRIBING THE FUNCTIONS OF THE 
MANY SPECIAL APL SYMBOLS, AND BY OUTLINING THE PROCEDURES FOR 
DESIGNING YOUR OWN FUNCTIONS , 



BACKGROUND 

THE APL TUTOR ASSUMES YOU HAVE HAD LINEAR ALGEBRA AND TRIGINOMETRY 
CALCULUS IS NOT NECESSARY , 

IF YOU HAVE NEVER HAD ANY COMPUTER PROGRAMMING BEFORE, DON’T WORRY 
YOU CAN START USING APL RIGHT AWAY, AS A SUPER -SOPHISTICATED 
CALCULATOR WITH MANY BUILT-IN FUNCTIONS, 

IF YOU HAVE STUDIED OTHER COMPUTER PROGRAMMING LANGUAGES, RELAX , 
APL IS NOT LIKE ANY OF THE OTHER MAJOR HIGH-LEVEL LANGUAGES, 

YOU CAN FORGET ABOUT DATA TYPES, INPUT/OUTPUT FORMATTING, AND 
MANY OF THE OTHER TEDIOUS DETAILS OF FORTRAN, PASCAL, ETC, 

AFTER YOU ARE SUFFICIENTLY FAMILIAR WITH THE CALCULATOR MODE 
OF APL, YOU CAN LEARN TO DEFINE YOUR OWN FUNCTIONS WITH EASE , 
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BASICS 



HERE IS SOME BASIC INFORMATION YOU WILL NEED TO KNOW IN ORDER TO 
UNDERSTAND THE APL TUTOR LESSONS , 

MONADIC AND DYADIC FUNCTIONS 

YOU ARE ALREADY FAMILIAR WITH SYMBOLS WHICH REPRESENT ARITHMETIC 

FUNCTIONS, SUCH AS + CR + , APL USES THESE SYMBOLS AND MANY OTHERS 
TO REPRESENT A VARIETY OF FUNCTIONS, 

MANY FUNCTIONS, SUCH AS + , REQUIRE TWO ARGUMENTS, THAT IS, TWO INPUT 
NUMBERS, IN APL, THESE ARE CALLED DYADIC FUNCTIONS, AND THE SYMBOL 
IS PLACED BETWEEN THE ARGUMENTS J FOR EXAMPLE , 3 + 4 , 

OTHER FUNCTIONS, SUCH AS LN (NATURAL LOG), REQUIRE ONLY ONE ARGUMENT, 
THESE MONADIC FUNCTION SYMBOLS ARE PLACED TO THE LEFT OF THE DATA 
WHICH THEY ARE TO OPERATE ON, FOR EXAMPLE, LN 3 IN APL IS 33 , 

DATA TYPES 

APL DISTINGUISHES ONLY TWO TYPES OF DATA* NUMERIC AND CHARACTER, 

VERY SIMPLY, CHARACTER DATA ARE ENCLOSED IN QUOTES (■) WHEN ENTERED, 

'2' IS CHARACTER DATA; 2 IS NUMERIC DATA, SOME FUNCTIONS 
WILL OPERATE OH BOTH TYPES OF DATA, SOME ONLY ON NUMERIC, 

ARRAYS 

THE GREATEST STREHGTH OF APL LIES IN ITS ABILITY TO TAKE AN ENTIRE 
ARRAY OF NUMBERS AS A SINGLE ARGUMENT, THUS TWO MATRIXES CAN BE 
ADDED BY ENTERING SIMPLY A+B, WITH NO SUBSCRIPTS, LOOPS, ETC, 

THIS MAKES IT IMPORTANT TO KNOW THE RANK (THE NUMBER OF DIMENSIONS) 

OF DATA IN USE, A SINGLE NUMBER IS NORMALLY A SCALAR (RANK Q ) , 

A SERIES OF NUMBERS IS A VECTOR, A ONE-DIMENSIONAL ARRAY (RANK 1), 
NUMBERS CAN ALSO BE ARRANGED IN ROWS AND COLUMNS, TO MAKE A MATRIX 
(RANK 2)* MATRIXES CAN BE 1 STACKED 1 TO MAKE UP THE PAGES OF A 
THREE-DIMENSIONAL ARRAY, OFTEN CALLED A BOOK (RANK 3), IN FACT, 
THERE IS NO LIMIT TO THE NUMBER OF DIMENSIONS IN AN APL ARRAY, 

THE LENGTH OF THE DIMENSIONS IS ALSO EFFECTIVELY UNLIMITED, LENGTH 
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REFERS TO THE HUMBER OF ELEMENTS IH A DIMENSION, FOR EXAMPLE, 

THE NUMBER OF ROWS # LENGTH MAY EVEN BE Q * 

IN THIS TUTORIAL, A SCALAR MAY BE REFERRED TO AS S, L, OR R, 

A VECTOR MAY BE CALLED V, VI, OR V2 , WHILE A MATRIX IS M , Ml, OR M2, 
AN ARRAY, WHICH MAY BE A VECTOR, A MATRIX, OR AN ARRAY OF ANY HIGHER 
DIMENSION, WILL BE LABELLED A, A*, OR A2, 

EXAMPLES 

WHEN EXAMPLES ARE GIVEN IN THE TEXT OF A FUNCTION DESCRIPTION, THE 

SYMBOL => IS USED BETWEEN THE EXAMPLE INPUT AND THE EXAMPLE OUTPUT, 

FOR example: 2+5 => 7 

THIS SYMBOL CAN BE READ AS 'PRODUCES 1 OR 'RETURNS', 



ERRORS 

YOU SHOULD NOT RECEIVE ANY ERROR MESSAGES WHILE USING APL TUTOR, 
HOWEVER, YOU MAY SEE A PHRASE LIKE ‘VALUE ERROR* (WITHOUT QUOTE 
MARKS) WHEN YOU ARE EXPECTING A NORMAL RESPONSE, 

OR IF YOU ACCIDENTALLY HIT THE ENTER KEY WHEN THE COMPUTER IS NOT 
EXPECTING AN INPUT, THE FUNCTION MAY END ABRUPTLY, LIKE THIS: 

MENU [<£] 

IF EITHER OF THESE THINGS HAPPEN, BE SURE TO ENTER J (UPSHIFT f) 

THEN RESTART WITH ANY COMMAND, 

HALTING A LESSON 

YOU MAY STOP ANY LESSON AT ANY POINT WHERE A QUESTION IS ASKED 
BY ENTERING: STOP 

TO SEE THIS INFORMATION AGAIN AT ANY TIME, ENTER; BASICS 
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HOWTEACH 



YOU MAT START A LESSON IN THREE WAYS J 

(1) enter; lesson nextlessgn 

TO start the lesson follwing the last one you completed, 

(2) enter; lesson nnh (where nnn is a 3-digit number) 

TO START lesson number nnn, 

TO SEE A LIST OF LESSON NUMBERS, ENTER; MENU 

(3) enter; teach 

TO SELECT THE SYMBOL THAT YOU WANT A LESSON ON, 

TO SEE THIS INFORMATION AGAIN AT ANY TIME, ENTER ♦ HOWTEACH 
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APPENDIX B 
PROGRAMMER'S GUIDE 



A. FLOW CHARTS 

Figure B.1 shows the relationship of the various func- 
tions within the TUTOR workspace. The first function called 
by the new student should be START. Afcer that, the student 
will usually commence a session by calling MENU, TEACH, 
HELP, LESSON, or INFO. These functions in turn call the 
other functions of TUTOR as indicated by the arrows. The 
procedure of these functions is outlined in figures B. 2 
through B.21. 

In APL, there is no difference in the programming of 
main routines, subroutines, and functions; all are referred 
to as functions. However, when one function calls another 
function, the calling function is suspended until the called 
function is completed. Then the calling function resumes 
operation, possibly using the result of the called function. 
Therefore, "return to the calling function, if any" is 
implied at the end of every program but is not explicit. 
END, implying return, is shown in the diagrams only in those 
functions which are normally called by another function. 

It should be noted that "room for expansion" has been 
provided in the SHOW, RUNDRILL, DRILL, ana TEST functions. 
RUNDRILL and DRILL have the capability to display drill 
questions with matrix arguments. This capacity is not 
currently being used because the answer must be inpun in 
vector form. It was felt than this might confuse the 
student. However, further development and experimentation 
might find uses for this type of question, so the matrix 
form has been left available. TEST and SHOW have calling 
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lines for the matrix form commented out. There are also 
comment lines in SHOW to indicate w here matrix and higher- 
level arrays questions would go if they are added in the 
future. See the section on making modifications for more 
information. 

The four functions at the bottom of figure E.1 are not 
part of the TUTOR function hierarchy. NSXTLESSON is used to 
provide a lesson number when the student calls for LESSON 
NEXTLESSCN. OKDERMAT is provided for the benefit of the 
programmer to rearrange the sequence of lessons in the 

course. TEST is also provided for the programmer (or 

student) who wishes to run only the drill section of a 

lesson. SQUEEZE is a utility called by several functions to 

delete blanks in a string of characters. 
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START 




MEXTLESSON 




ORDERMAT 




TEST 




SQUEEZE 



Figure B. 1 Interrelationship of TUTOR Functions 





Basf c 
Infor- 
mation 



Figure B. 2 Procedure of ST&ST Function. 




Figure B.3 Procedure of HEHU Function. 
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Figure B.4 Procedure of HELP Function. 
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Ending 

message 



Figure B.5 Procedure of IHFO Function. 
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Figure B.6 



Procedure of RON Function 






Figure 3.7 



Procedure of TEACH Function 




Figure B. 8 Procedure of LESSON Function. 
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Figure B.9 Procedure of SHOW Function — 1. 
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Figure B.10 Procedure of SHOW Function--2. 
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Procedure of SHOW Function--3. 
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Figure B.11 






Figure B.12 Procedure of ASK Functiou. 
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(WT) 

SUMASK 

can- 




Figura B.13 



Procedure of SUMASK Function 




Figure B. 1 4 Procedure of SCORE Function. 
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Figure B. 15 Procedure of RiJNDRILL Function. 
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Figure B. 1 6 Procedure of DRILL Function. 
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Figure B. 17 Procedure of POLL Function. 
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Figure B.18 Procedure of TRY Function — 1. 
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Figure B.19 Procedure of rsi Function — 2. 
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Figure B. 2 0 



Procedure of TEST Function. 
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Figure B.21 



Procedure of SQUEEZE, NEXTLESSON, and ORDERMiT Fns 



B. FUNCTIONS 

The following section contains the APL functions which 
operate the TUTOR course. The comment lines, which begin 
with a symbol, indicate the procedure in general, but do 
not describe the specific programming techniques used. 
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7 START 



[1] a ENSURES 1 HOW 1 ARREARS WHEN WORKSPACE IS LOADED 

[ 2 ] [jLXf'HOW' 

[3] fl DISPLAYS INFORMATION FOR FIRST-TIME USER 

[4] QflHTRO 

[53 Of BACKGROUND 

[£3 Qf BAS ICS 

[ 7 ] QfHOWTEACH 

C8] DR£E : 5 ,to START YOUR FIRST LESSON IN APL , ENTER } LESSON IQ 
7 
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7 MENU ; Z Z Z 

[1] 3 REQUIRES GLOBAL VARIABLE MAT 

[23 Of. * INFORMATION IS AVAILABLE OH THE FOLLOWING SYMBOLS /TOPICS* 1 
C3] fl FORMAT AND DISPLAY MENU 

[43 zzz«.<5fl)f<M17fl)»0 

[53 ( (T ( (fMAT)[l])r3) r72)f222\MATC}LESCOL f SYMCOL f FMAMECOL] 

C6] D** ,T0 SEE MENU AGAIN , ENTER; MENU 1 , CR ,» FOR INFORMAT 

ION ABOUT FUNCTION, ENTER; INFO NNN (WHERE NNN IS MENU NUMBER) 
' ,CR,*TO GO THROUGH TUTORIAL LESSON, ENTER; LESSON NNN 1 
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7 HELP } SYMBOL } ROWS J NNN ,* R 

[I] R CALLS QUEUE , MENU , SQUEEZE 

[23 Of 1 ENTER THE SYMBOL(S) YOU WOULD LIKE INFORMATION ABOUT, 1 

C3] op 1 or,,, for menu selection, enter; menu* 

[4] fl DELETE blanks in response 
C5] SYMBOL f SQUEEZE SYMBOLfQ 

161 ft IF RESPONSE is ‘MENU 1 , GO TO ‘OTHER*} ELSE GO ON 
[7] MOTHER X \ ( 4 = + /+ /SYMBOL o , = ! MENU * ) 

C83 ft FINE* INDEXES OF ROWS THAT CONTAIN THE RESPONSE IN SYMBOL COLUMN 
£9] ROWSf ( MAT[ JSYMCOL ] € SYMBOL ) /\ ( f MAT ) [ 1] 

C103 ft NO ROWS CONTAIN RESPONSE, GO TO ' OOPST » } ELSE GO ON 

[ II ] 4OOPS3x\0=f ROWS 

[123 ft START LOOP COUNTER AND SET LESSON NR TO 0 

C133 HNNfRfO 

[14] ft INCREMENT COUNTER 

[15] NEWROWJRfR+l 

C 1 63 

C173 ft O^LL RUN TO DISPLAY HELP FUNCTION FOR ROW CORRESPONDING TO COUNTS 
R 

C183 RUN ROW5[R] 

C193 ft IF MORE ROWS REMAIN, RETURN TO NEWROW} ELSE GO ON 
C203 -t N E W R O W x \ R < f ROWS 

C213 ft PRINT FUNCTION ENDING MSG AND EXIT 
C223 Of' FOR MORE HELP, ENTER* HELP* 

C233 40 

[24 3 ft SYMBOL NOT FOUND } PRINT ERROR MSG AND EXIT 

[253 OOPS3*Qf * SORRY, INFORMATION ABOUT THIS SYMBOL IS NOT AVAILABLE AT T 
HIS TIME, 1 f CR, ‘ FOR HELP WITH ANOTHER SYMBOL, ENTER* HELP, 1 

C263 40 

C273 ft RESPOMSE IS ‘MENU * } EXECUTE RESPONSE AND EXIT 
C283 OTHER J ^SYMBOL 
7 
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? info hnnjrow 

111 CALLS run; requires global variable mat 

[23 S I F NMM IS NOT A SCALAR, GO TO 'OOPS].; ELSE GO ON 

[33 +OQPS1X1 (f fHHN) >0 

[ 4 ] B FIND INDEXES OF ROW 

[53 ROWf ( ( i, mat[ ;LESCOL3 )=um)/\ (/-mat) [ 13 

[£] ft IF NO ROWS CONTAIN RESPONSE, GO TO 1 OOFS3 ‘ ; ELSE GO ON 

[73 +OOPS3X 10 =f sow 

[93 a RUN HELP FUNCTION 
[93 RUN ROW 

[103 ft DISPLAY ENDING MESSAGE 

C113 [JpCRj'FOR MORE INFORMATION, ENTER; INFO NHN 1 

C123 40 

C133 ft VECTOR ARGUMENT; PRINT ERROR MSG AND EXIT 

[143 00P31 ; Qp 1 INFO MUST BE FOLLOWED BY A SINGLE P AR AMETEF: # • , CR , 1 TO RESTA 
RT, ENTER; INFO NNN (WHERE NHN IS A THREE-DIGIT NUMBER ) 1 

[153 40 

C163 ft IHFO NOT FOUND; PRINT ERROR MSG AND EXIT 

[173 0 0 P S 3 J 0 r 1 SORRY, INFORMATION ABOUT THI S SYMBOL IS NOT AVAILABLE AT T 
HIS TIME, { , OR, * FOR HELP WITH ANOTHER SYMBOL, ENTER; HELP , 1 
7 
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v RUN ROW} NAME }RANK J FNAME JU 
Cl] ft CALLED BY HELP, INFO, TRY} CALLS SQUEEZE 
[2] ft REQUIRES GLOBAL VARIABLE MAT 

C3] ft A 3 S I G N THE NAME OF THE HELP VARIABLE TO THE VARIABLE 'NAME* 

[4] NAMEf , MAT [ROW }N AMEC OL ] 

C5] ft G0 T0 Nft IF THE HELP VARIABLE 'NAME* DOES NOT EXIST} ELSE GO ON 

[6] 4NAx\0=GNC name 

[7] fl DISPLAY THE GENERAL DESCRIPTION PORTION OF THE HELP VARIABLE 
C8] DHO l)^((iNAME)[;i]=* , ■ )/ ± NAME 

[ 9 ] ft DISPLAY SCALAR PORTION OF HELP VARIABLE 
CIO] D«-(0 l)4((iHAME)C;i]=‘o« )/3 lNAME 
l 11] ft IF NO MORE INFO, EXIT } ELSE GO ON 

C 12] ->0X \ *1 * ( iNAME ) [ } l 3 £ ' Vfl* 1 

C13] ft ASK IF MORE DETAILED INFO DESIRED 

c 14 ] 0 <r£E? ' more? 1 

C151 ft IF RESPONSE IS NULL, EXIT } ELSE GO ON 

C16] ^0X\0=fUfQ 
C 17] -K)X\A' , T , r< fU)El] 

C18] ft DISPLAY VECTOR PORTION OF HELP VARIABLE 
C 19] DM0 m< (iHAME)[f 1]=' V* )/iWAME 
c 20 3 ft DISPLAY matrix PORTION of HELP VARIABLE 
[21] QMO l)*((±NAME)E}l]=*ft*)/ t NAME 

C22] ft DISPLAY ALL ARRAYS PORTION OF HELP VARIABLE l 

C23] DM0 l);((iNAME)E}i3=:'*')/ 1 NAME 
C24] 40 

C25] ft ASSIGN full name of symbol to VARIABLE ‘FNAME' } print error MSG 
C26] NA JFNAMEf SQUEEZE , MAT [ ROW } FNAMECOL] 

c 27 ] DfCR,«SORRY, INFORMATION ABOUT ', FNAME,' IS NOT AVAILABLE AT THIS 
TIME, ' 

V 
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V TEACH i SYMBOL } ROWS } NNN } R 
[I] ft CALLS SCHEDULE, MENU, SQUEEZE 

C2] Q«-' ENTER THE SYMBOL(S) YOU WOULD LIKE INFORMATION ABOUT t * 

[3] Q*- 1 OR FOR MENU SELECTION, ENTER J MENU 1 

[4] « DELETE BLANKS IN RESPONSE 
[53 SYMBOLf-SGUEEZE SYMBOLmQ 

[63 ft IF RESPONSE IS 'MENU 1 , GO TO 'OTHER' } ELSE GO ON 
[73 MOTHER X \ ( 4=+/+ /SYMBOL* # = ‘ MENU • ) 

[83 ft FIND INDEXES OF ROWS THAT CONTAIN THE RESPONSE IN SYMBOL COLUMN 
[93 ROWS*- ( MAT [ } SYMC OL 3 g SYMBOL )/ \ ( * MAT ) d ] 

[103 ft IF HO ROWS CONTAIN RESPONSE, GO TO 1 0 0 P S 3 1 J ELSE GO ON 

[113 ->ooPS3x\0=f ROWS 

[123 ft INITIALIZE LOOP COUNTER AND SET LESSON NR TO 0 

[133 MNNfRf-0 

[14] ft INCREMENT COUNTER 

[153 newrow ;r*-r+i 
[163 CU-E5 

[173 ft CALL SHOW TO DISPLAY TEACH FUNCTION FOR ROW INDEXED BY COUNTER 
[183 SHOW ROWS[R] 

[193 ft IF ROWS REMAIN, RETURN TO NE WROW} ELSE GO ON 
[203 4 H E W R 0 W x \ R ( f ROWS 

[213 ft DISPLAY END OF SCHEDULE MSG AND EXIT 

[223 DfCR, 'THIS IS THE END OF SCHEDULED LESSONS f CR ,« TO SELECT MORE LE 
SSONS, ENTER; TEACH' 

[233 ->0 

[243 ft SYMBOL NOT FOUND} PRINT ERROR MSG AND EXIT 

[253 OOPS3 *0<- 1 SORRY , INFORMATION about this symbol is not AVAILABLE AT T 
HIS TIME # CR, ' FOR LESSONS ON ANOTHER SYMBOL, ENTER; TEACH' 

[263 40 

[273 ft RESPONSE IS 'MENU'} execute response and exit 
[28] OTHER ; ± SYMBCL 
7 
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7 LESSON NNN} ROW 

[1] ft CALLS SHOW 

[2] ft IF HHH IS H0T A SCALAR, GO TO ' OOPS 1 } ELSE GO ON 

[3] 400PS1X\ (f fMHN) >0 

[4] fi SELECT ROW FOR LESSON NUMBER NNN 

C5] ROWf ( ( ± ,MATC ;LESC0L])=HMN)/\ (f MAT) [i] 

L61 ft IF H0 CONTAIN RESPONSE, GO TO « OOPS3 ' } ELSE GO ON 

[7] ^ooP53x\0=f* ow 

[g] ft CALL SHOW TO DISPLAY TEACH FUNCTION FOR ROWS SELECTED 
[9] SHOW ROW 

[IQ] ft DISPLAY ENDING MESSAGE AND EXIT 

Cll] DP 'TO START ANOTHER LESSON, ENTER* LESSON NNN' 

C12] AO 

[13] ft VECTOR ARGUMENT} PRINT ERROR MSG AMD EXIT 

[14] OOPS1 *0P ' LESSON MUST BE FOLLOWED BY A SINGLE PARAMETER t 1 , C R , 'TO RES 

TART, ENTER; LESSON NNN (WHERE NNN IS A THREE-DIGIT NUMBER) 

i 

[15] AO 

[16] fi LESSON NOT FOUND} PRINT ERROR MSG AND EXIT 

[17] 0 0 P S 3 J Q P 1 SORRY, INFORMATION ABOUT THIS SYMBOL IS NOT AVAILABLE AT T 

HIS TIME , • ,CR FOR HELP WITH ANOTHER SYMBOL, ENTER ♦ HELP,‘ 

V 
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V SHOW ROW } NAME } G} RANK } FNAME } Y } RT }WT }GV } AV } TYPE } ARG } SS } F } SYM 

[I] fl CALLED BY SCHEDULE, LESSON } CALLS ASK, R U N DRILL , TRY. SQUEEZE 
C2] ft REQUIRES GLOBAL VARIABLE MAT 

C3] ft SET VARIABLES CORRESPONDING TO ROW 
[4] NAME*-, MAT [ROW} NAME COL] 

C5] FNAME^SQUEEZE , MAT [ROW JFNAMECOL] 

C6] sym<-mat[row;symcol3 

[7 ] RANK (-MAT [ROW } SVXACOL ] 

[3] TYPEf- MAT [ROW } MDCOL ] 

[9] ARG«-MAT[ROW } NKCOL ] 

CIO] ft GO TO 'HA' IF HELP VARIABLE DDES HOT EXIST} ELSE GO ON 

[II] AHAX\(0=0HC NAME) 

C12] ft INITIALIZE TOTAL QUESTION, WRONG ANSWER COUNTERS 

[13] *TfWT^0 
C14] r*\Q 

C15] ft 

[16] ft display general portion cf help variable 

[17] 0M0 l)*((±«fiME)[}l]=' , ‘ )/»HAME 
C18] ft general questions 

C 19] 0Vfi, (5 x\type=«d« ),6 

C20] AVf.( tl + TYPE= « D 1 ) , SQUEEZE RANK 

[21] QV ask 

[22] ft CHECK NUMBER OF RIGHT ANSWERS 

[23] WT SUMASK RT 

C24] ft IP PLAG INDICATES 'STOP' RESPONSE, GO TO HALT} ELSE GO ON 

[25] 4HALT X Y=2 

[ 26 ] ft 

C27] ft DISPLAY scalar portion of help variable 

[28] QMO l) + ((iHAME)[}l]='o‘)/ t NAME 

[29] ft SCALAR QUESTIONS 

[30] 4SDx\TYPE=*M' 

C31] av<-2 

[32] AV^'NY « [ 1 + S Y M £ * +xri = F'vvAA' ] 
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GV ASK AV 



C 33 3 

[34] ft IF* FLAG INDICATES ’ STOP ' RESPONSE, GO TO HALT} 

[35] *HALTXY=2 

C363 ft SCALAR DRILL 

[37] SDJ4VX^STM € S5^ • + - X r T L J I * \ * < 1 = > > 1 vA v A , f ft * 

[38] *Vx l ( (SYM € ' +*f , 1 ) aTYPEs *M • ) v(SYM € 1 \ 1 ) aTYPE= • D • 

[39 3 1 R U H DRILL 1 

[40] ft IF* FLAG INDICATES 'STOP' RESPONSE, GO TO HALT ; 

[41] 4HALTXY=2 

[42] ft 

[43] ft DISPLAY VECTOR PORTION OF HELP VARIABLE 

[44] vjQf(o 1 )+(<iHame)c il]=* V )/!MAM e 

[45] ft ASK VECTOR QUESTIONS 
[463 4VDX \ TYPES' M' 

[473 

[483 AVf 'FT'Q+SYMgSS, • «-[ € * jltT 1 3 

[49] QV ASK AV 

[503 ft 1F flag indicates 'stop 1 response, go to halt; 
[51] 4HALTX Y=2 
[523 ft VECTOR DRILL 

[533 VDj4Xx\(-rSYM € SS, ‘ncAA + Me 1 )v(<SYM* • ,+A* )ATYPE 
TYPE= ' D 1 

[543 4VSx\(5YM £ * * ' ) 

[553 1 RUndrill 2 

[563 ft IF flag indicates 'stop* response, go to halt; 

[573 4HALtxy=2 

[583 VS* 4 VVx\ (5TM £ • Of • ) aTYPE= • M * 

[593 4^X1 (SYM 6 'ff+0e' ) yTYPEr 1 M 1 

C60] 2 RUNDRILL 1 

[613 ft if flag indicates 'stop* response, go to halt; 

[62] 4HAltxy=2 

[63] vv;4)<x\sym £ « x • 

[64] 2 RUNDRILL 2 

[65] ft IF flag INDICATES ‘STOP 1 RESPONSE, GO TO HALT; 



ELSE GO ON 



ELSE GO ON 



ELSE GO ON 



)v(SYMg * /\/\ * ) 



ELSE GO ON 



ELSE GO ON 



ELSE GO ON 
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C66 ] 
C67] 


4HALTX'T=:2 














R — — - - -- 














[68] 


8 DISPLAY MATRIX PORTION OF HELP VARIABLE 










[69] 


:: !l]<-(0 1 ) !< ( jHAME ) [ } 13= ' ft ' )/±HAhE 














[70] 


ft ASK MATRIX QUESTIONS 














[71] 


A x \ T Y P E = ' M ' 














[72] 
















[73] 


A V <- * F T 1 [1 + SiM £ ' +-X-rS*;rL 1 =^<i> >v*-a> 


' ] 












[74] 


Q V ASK AV 














[75] 


ft IF FLAG INDICATES * STOP 4 RESPONSE, 


GO 


TO 


halt; 


ELSE 


GO 


ON 


[76] 


4HALTX f=2 














[77] 


ft MATRIX DRILL 














[79] 


MD { flTYPE RUNBRILL 3 














[79] 


ft IF FLAG INDICATES 'STOP' RESPONSE, 


GO 


TO 


HALT J 


ELSE 


GO 


ON 


[80] 

[81] 


4HALTX T=2 














ft - - - ~ 














[82] 


ft DISPLAY ALL ARRAYS PORTION OF HELP 


VARIABLE 








[83] 


AJQMO l)4r<(iHAME)c;i3=* )/±hame 














[84] 


ft ASK ALL ARRAYS QUESTIONS 














[85] 


«Vf3,9x\XFf+/(l 2)XfAPG € «KE* 














[86] 


AVf ( 1 NY 1 [1-fXF]) , SQUEEZE « LRB • [l + F] 














[37] 


QV ASK AV 














[88] 


ft IF FLAG INDICATES 'STOP* RESPONSE, 


GO 


TO 


HALT J 


ELSE 


GO 


ON 


[89] 

[90] 


4HALTxT=2 














ft _ ___ 














[91] 


ft SUMMARIZE 5TUDENT PERFORMANCE 














[92] 


SUM * W7 SUMASK RT 














[93] 


ft IF FLAG INDICATES ‘STOP* RESPONSE, 


GO 


TO 


HALT } 


ELSE 


GO 


ON 


[94] 

[95] 


4HALTxi=2 














ft* 














[96] 


ft CALL TRY FOR SELECTED SYMBOLS 














[97] 


EXF J^ENDxt *(SYM S '+-XS' )aTYPE='D' 














[98] 


TRY SYM 














[99] 


ft IF FLAG INDICATES 'STOP* RESPONSE, 


GO 


TO 


HALT $ 


ELSE 


GO 


OH 



52 



[1003 


4HALTx’t=2 


C 101 1 




[1023 


ft LESSON COMPLETE; IF NHN = 0 (TEACH), EXIT | ELSE SO OH 


[1033 


END{40X\WWW=0 


C 1043 


ft HNNjfO (LESSON); SET LA5TLE550N TO THIS LESSON HR 


[1053 


OUT • L ASTLESSONf NHH 


[1063 


DISPLAY MSG AND EXIT 


C1073 


Q<-CR, 'THIS IS THE END OF YOUR LESSON,' 


[1083 


Of FOR THE NEXT LESSON IN SEQUENCE, ENTER; LESSON NEXT LESSON ‘ 


[1093 


40 


[1103 


HELP VAR NOT AVAILABLE; DISPLAY ERROR MSG AND EXIT 


[1113 


NAJCR, 1 SORRY, INFORMATION ABOUT * , FN AME , ' IS NOT AVAILABLE AT THI 



TIME , 



[1123 


->0 


[1133 


HALT * CR , ' THI 5 LESSON HAS BEEN HALTED,' 



V 



7 QUES ASK ANS } R } W } I } A } L } AR } R K } Q 
Cl] ft CALLED BY SHOW,* CALLS SCORE 

l21 ft REQUIRES mom-local variables rt,wt,y, global cues 
[33 ft ASSIGN THE NUMBER OF QUESTIONS TO • R ■ 

[4] R Pf f QUE5 

[53 ft ASSIGNS TOTAL NUMBER OF QUESTIONS TO 'RT' 

[63 RTfRT+R 

[73 ft IF HR QUESTIONS y£ NR OF ANSWERS, GO TO •OOFS'} ELSE GO ON 

[33 ->oopsx\**p f ahs 

[93 fi INITIALIZE COUNTER, CHARACTER VARS 

[103 ipO 

[113 ft START LOOP} INCREMENT COUNTER} INITALIZE WRONG ANSWER COUNT 
[123 START{IfI+l 
[133 «f0 

[143 ft ASSIGN QUESTION AND ANSWER PARAMETERS FOR ASK FUNCTION 

[153 fi P( f fl N5)[I] 

[163 Qf-CR, *CUES[( , SUES) [I]}] 

[173 ft CALL •SCORE 1 TO EVALUATE THE QUESTION 

[183 gueryja score q 

[193 ft IF f LAG INDICATES 'REPEAT*, RETURN TO SAME QUESTION} 

[203 ft I F FLAG INDICATES 'STOP' RESPONSE, EXIT} ELSE GO ON 
[213 4 (QUERY F 0)C Y 3 

[223 ft IF * QUESTIONS REMAIN, RETURN TO 'START'} else exit 
[233 4STARTX\I<R 
[243 ->0 

[253 ft F °F: DEBUGGING; ARGUMENTS NOT SAME LENGTH} print error MSG and EX I 
T 

[263 CQPSJOf- 1 f QUES fANS' 

V 
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V A SCORE 0} INPUT 
ft CALLEI' BY ASK 

[2] ft REQUIRES NON-LOCAL VARIABLES Y,W,WT 

[3] ft DISPLAY TEXT OF QUESTION 

[4] DR* 

[5] ft ASSIGN RESPONSE TO 'INPUT' AFTER DELETING BLANKS 

[£] INPUT*. SQUEEZE INPUT*-Q 

C7] ft * F RESPONSE IS NULL, ADD 1 WRONG ANS AND GO TO 'LAST'; ELSE GO ON 
[33 WT«-WT+Q = f INFUT 

[93 4LASTxiO=f INPUT 

CIOj ft RESPONSE IS 'STOP', GO TO 'OUT'; ELSE GO ON 

[113 ->DUTx \ 4 = + / + / INPUT o , = 1 STOP « 

[12] ft IF RESPONSE RIGHT ANSWER, GO TO 'WRONG 1 ; ELSE GO ON 
[133 N E X T ♦ 4 W ft ON G x \ ( , INPUT )[ 1 ]*A 
[143 ft DISPLAY MSG 
[153 Q *. 1 RIGHT' 

Ll 6 ] ft SET FLAG TO NULL; EXIT 

C17] 0 y 7 \ 0 

[183 ft INCREMENT WRONG ANSWER COUNTERS 
[193 WRONG JW4-W+1 
[203 WTfWT+1 

[213 ft 00 TO LAST IF THREE WRONG ANSWERS TO THIS QUESTION; ELSE GO ON 

[22] 4LASTx\w>3 

[23] ft DISPLAY MSG 

[24] Q f ‘ SORRY, PLEASE TRY AGAIN' 

[25] ft SET flag to indicate repeat question; exit 

[26] 40»*T>1 

[27] ft 40 

[28] ft three wrong answers; display msg 

[29] LAST ♦ Qf 'SORRY , THE CORRECT ANSWER IS ',A 

[30] ft SET FLAG TO INDICATE GO TO NEXT QUESTION} EXIT 

[31] 40>t>\0 

[32] ft SET FLAG TO INDICATE 'STOP* RESPONSE 

[33] OUTJY«-2 

V 
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7 WT SUMASK P. 



Cl] 

C2] 

C3] 

C4] 

C5] 

C61 

C7] 



CALLED BY SHOW AFTER ALL 'ASK' CALLS 

IF FEWER WRONG RESPONSES THAN QUESTIONS, EXIT} ELSE GO ON 
40X \WT<R 

A WRONG RESPONSES > QUESTIONS; DISPLAY MESSAGE AND EXIT 
Qf'YOU ENTERED 1 ,( t WT),' WRONG ANSWERS OUT OF 1 , ( t R ) , ' QUESTIONS, 
□f'IF YOU WANT TO RETAKE THIS LESSON, ENTER* LESSON ' , * , M A T [ROW 
LESCOL ] 

Y<-2 

7 
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7 L RUNDR ILL H } FUNC } R } K [ } K2 } <3 } A } W } C } M 

[1] (, CALLED BY SHOW } CALLS DR I LL , FULL 

[2] ft REQUIRES NON-LOCAL VARIABLES SYM, TYPE 

[3] ft INITIALIZE ANSWER COUNTERS 

LAI CfWBO 
C5] start; 

[6] a EXTEND SYM FOR REDUCTION, SCAN 
L71 5YM«.((STM S '/\A* )/( * +-r L= ‘ )C?5])fSYM 
C8] A FORMAT FUNCTION DISPLAY 

191 

CIO] F U N C (- ( R , 3 ) f 1 1 , S Y M , ' 

C 1 1 □ a SET MULTIPLIER 

C 12] M«-?3 

C13] fl pull random number arguments 

[14] Klfl PULL L 
Cl 5] K2r2 PULL N 

C16] ft IF K 1 IS EMPTY vector, exit; else go on 
C 17] ->0n0 = f r K 1 

C18] ft ~ F TYPE IS MONADIC, GO TO MONTY} ELSE GO ON 
[19] -*MOHTYx \ TYPE= 1 M ' 

C 20 3 ft format dyadic a / a 
[ 21] a«.< t Ki) # FUNC, t K2 
C22] APs(tfKl) ,SYM,t,K2 
[23] -»Rum 

C24] ft format monadic a/a 

[25] monty; 

[26] Ot-FUNC, t K2 

C 27 ] Afi5YM,*,K2 

[28] a run drill 

[29] run; a drill a 

C30] a delete extra symbol (IF ANY) 

[31] SYMB-ifSYM 

C32] ft IF STOP FLAG IS SET, EXIT} ELSE GO ON 
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[33] 4 0 x f = 2 

[34] ft IF WRONG ANSWERS >_ 3, GO TO ' REV ' } ELSE GO ON 

[35] 4REVXIW>3 

[36] ft IF Right answers < i, return to 'start 1 ; else exit 

[37] 4STARTX\C<1 

[38] 40 

[3?] Rev; 

[40] QpCR, 'PLEASE REVIEW THE DESCRIPTION OF THIS FUNCTION OR TALK WITH 
TOUR', CP.,' INSTRUCTOR BEFORE RETURNING TO THIS UNIT,' 

[41] »>2 
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v z pp pull H}r;c;l;h;e}pool 

[1] a CALLED BY R U N DRILL 

[23 R REQUIRES ho?^— local variables sym, m 
[33 A SET DEFAULT VALUE 

[43 

[53 A p IS 1 FOR LEFT ARG f 2 FOR RIGHT ARG 

[63 A SET MULTIPLIER BASED OH M FROM l TO 3 (EXCEPT MONADIC f[) 

[7] MULTp( (10*M-2) yO»l>Cl+(S!M[13 £ -fL* )a(TYPE=«M* ) A v ( - l rs ™ ) € * A/\ 1 3 
[33 A N IS RANK OF DESIRED RANDOM ARRAY j ASSIGN ROWS AMD COLUMNS TO R A 
H D C 

[93 R M 1 » 1 1 2 ) C M 3 
[103 cp( 1, (1+M) ,2)[M3 

[113 A DETERMINE LIMITS BASED ON TYPE OF SYMBOL 

[123 P 0 N D J P 0 0 L p \ o 

[13] POOLpPOOL, ( S Y M [ 1 ] g 1 +~ X f L t = ) /MUL T X H , Q 7 -H P \ 9 

[14] POOLpPOOL , ( ( S Y M [ 1 ] g * f + f | $$8 1 ) AP = 2 ) /mult X H , 0 , -H 

[15] POOLpPOOL, ( ( SYM[ 1 ] £ ' ) A F* = 1 )/E f -Ep \ IfM 

[16] POOLpPOOL, ( (SYM[1] £ * | 1 \*f ' ) )/2f3»4 

[17] POOLpPOOL, ( S Y M [ 1 ] £ • p' )/MULTxD,-Dp2,4*5f 3 
[13] POOLPPOOL, <SYM[13 € »VA V A*« )/ o 1 

[19] POOLPPOOL, ( (SY«[1] = « * « ) aTYPEz 1 M • )/\ , * \Z 
[20 3 4PZX\ (TYPES ' M « ) V 5IM[1]^' J 1 

[213 A KLUGE FOR LOGARITHM — K2 ALWAYS A POWER OF K 1 (POOL IS EMPTY) 

[223 POOLpPOOL, ( (SYM[1]=> ® « ) A ( T Y P E = ' D ' ) AP = 1 ) /2 , 3 f 10 
[233 4 p z x \ p = 1 

[24 3 zp(R,c>p( (sym[ !]=•*• )atype=‘d« ) / ( , k l ) *? ( f , k i ) f 3 

[253 a IF WO NUMBERS IN POOL, EXIT? ELSE GO ON 

[263 pz:40x\0=T f ool 
[ 273 POOLpioOf POOL 

[283 R PROVIDE ARRAY OF RANDOM MRS 
[293 zp(R,C)fP00L[ (RXC)?1003 

V 
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7 Q DRILL A;b;S&;SG;L 
Cl] ft COLLED Bl RUNDRILLJ CALLS SQUEEZE 

[2] ft requires noh-lccal variables c f w; global cr 
C33 start: 

LAI T >10 

[5] DISPLAY DRILL QUESTION 

l&l ASK J QfCR, 1 WHAT IS THE RESULT OF:' 

171 

[8] ft IF REPOMSE is 'STOP', GO TO 'HALT' ; ELSE GO ON 

[9] ^HALTx 14 = + / + / ' STOP 1 c ,=SBf5GUEEZE BfQ 
CIO] ft IF ANSWER IS NULL, GO TO WRJ ELSE GO ON 
CU] ->WP:x \0=f SB 

C 1 2 ] ft CHECK FOR NUMERIC RESPONSE 

C 13] ck * 4 n a x \ (OgSBg * 1234567890 ♦ ~ ' ) v*0s ~ ♦ 1 

[14] ft IF LENGTH CF RESPONSE LENGTH OF GIVEN ANSWER, GO TO 
GO ON 

Cl 5] 4WRX\ <f f A)*f 

C16] ft IF RESPONSE = GIVEN ANSWER, GO TO ' RT 1 J ELSE GO ON 
C 1 7 ] ->RTxt((,A)A, = , t B) 

C 1 8] ft answer is wrong; display answer 

C 1 9 ] WR { Qf 1 SORRY , CORRECT ANSWER ISy 

C20] 0p a 

c 2 1 ] ft INCREMENT WRONG ANSWER COUNTER AND RETURN TO RUNDRILL 

[22] w^w+l 
C23] 40 

C24] ft answer is right; display message 
C2j] stjo** ’ correct; ■ 

C26] ft increment right answer counter and return 
C 27 ] cpc + i 
C28] 40 

C29] ha;op c sorry, this answer not acceptable, p lease enter a 

WER , ' 

C30] 4 AS K 



' WR » ; ELSE 



NUMERIC ANS 
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STOP AT STUDENT REQUEST j SET FLAG AND EXIT 



[31] ft 

[32] HALT * 40 »'»> 2 

7 
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7 TRY 5YMJW}B}T}C}TW 
[13 fi CALLED BY SHOW} CALLS RUM 

[23 ft REQUIRES MOM-LQCAL VARIABLES ROW, SYM « FNAME 

[33 tw+q 

[43 RESTART {TWfTW+1 

C53 ft 00 T0 OUCH IF RESTART COUNTER EQUALS 3 

[63 ^ouchx \tw= 3 

[73 ft INITIALIZE FLAGS AND WRONG ANSWER COUNTER 

[83 T^-c^WfO 

[93 ft REQUEST STUDENT INPUT A LOGICAL EXPRESSION USING THE SYMBOL 

[103 start: 

C113 QfCR , 1 WRITE A TRUE STATEMENT USING 1 , SYM , ' # * ,CP, 'FOR EXAMPLE \ 4 = 2 + 

2 * 

C123 ft IF RESPONSE IS ‘STOP* , GO TO ‘HALT' ; ELSE GO ON 
[133 4HALTX M = + / + / ' STOP * * *=* + Q 

[143 ft IF RESPONSE IS A NULL OR A NAME, GO TO 'WRONG * ; ELSE GO ON 

[153 + WRONG X \ ( 4 *QNC B)vQ = f » 

C163 ft SET T=1 IF STATEMENT IS TRUE 
[173 NEXT } Tf i= a b 

[193 ft SET C=1 IF STATEMENT CONTAINS THE SYMBOL 
[193 C+SYM* B 

[203 ft SO TO RIGHT IF T AND C BOTH EQUAL 1} ELSE GO ON 
[213 +RI GHT X \ T AC 

[223 ft answer is wrong; increment counter 
[233 wrong; W fW+i 

[243 ft OO TO REV IF WRONG ANSWER COUNTER EQUALS 3 

[253 +REVx\w=3 

[263 ft 00 TO NOSYM IF THE STATEMENT IS TRUE; ELSE GO ON 

[273 +nosymx\t 

[283 ft print error msg 

[293 NT 5 Of- 1 SORRY, THIS STATEMENT IS NOT TRUE , * 

[303 ft 00 TO NOSYM IF THE STATEMENT DOES NOT CONTAIN THE SYMBOL; ELSE GO 
ON 
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[31] -)HOSYMx \ -vC 

[32] a print msg and return to start 

[33] Qf 1 TRY AGAIN,' 

[34] *start 

[35] ft PRINT ERROR MSS AND RETURN TO START 

[36] NOSYMJOf- ' YOUP ANSWER DOES NOT USE ' f SYM, ' , TRY AGAIN,' 

[37] -fSTART 

[38] ft PRINT MSG AND EXIT 

[39] RIGHT J Qf CORRECT { 1 

[40] 4Q 

[41] ft PRINT MSG AND RESTART 

[42] REVJQfCR, ' DO YOU WISH TO REVIEW THE DESCRIPTION OP 1 , FMAME , ' ? 1 F £5 » 1 

ENTER Y OR N,« 

[43] ft IP RESPONSE IS NULL OR NOT Y, GO TO RESTART , ELSE GO ON 

[44] 4RESTARTX \0=f BfQ 

[45] ^RESTART X \ * Y ' pf & 

[ 46 ] ft DISPLAY HELP VARIABLE , THEN RESTART 

[47] RUN ROW 

[48] ^RESTART 

[49] a three restarts? display message and exit 

[50] OUCH ♦,[]«- 1 PLEASE SEE YOUR INSTRUCTOR FOR ASSISTANCE,' 

[51] 40 

[52] ft STOP AT STUDENT REQUEST J SET FLAG AND EXIT 

[53] HALT ; 40 f Yf 2 

V 
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7 TEST HHH ; HAME ; 6 } RftHK ; FKAME ; T J F:T ; WT ; C?V ; ev ; TYPE ; 6P:G ; S5 



Cl] 


USED TO TEST DRILL ; CALLS RUNDRILL, 


TRY, SGUEE 


ZE 






C2] 


SET VARIABLES CORRESPONDING TO ROW 










C33 


ROW*. ( ( i , MAT[ } L £ 5 C 0 L 3 )sHHM) /\ ( j> MAT ) [ l ] 










C43 


NAME*- , MAT [ROW {NAME COL] 










[53 


FMAMEfSQUEEZE y MAT[ROW}FMAMECOL3 










C6] 


SYMf MAT [ROW J S YMCOL] 










C 7 3 


RANK {-MAT [ ROW ; SVKACOL ] 










C33 


TYPE*. MAT [ROW JMDCOL] 










C?] 


ARG{- MAT [ROW ; NKCOL J 










CIO] 


’’>10 










Cll] 


fl SCALAR DRILL 










C 12] 


5Dj4Vx\A'SYM£S3f , +-XTrLJi*\ft<i->./;*vAvAy/$ l 








C 13] 


V x 1 ( ( 5 T M £ • 4* If f , • ) ATY PE= ‘ M • ) v( S i'Mj • \ * ) aTYPEs ' D ' 








C 14] 


1 RUNDRILL 1 










C 153 


fl IF FLAG INDICATES 'STOP' RESPONSE, GO 


to halt; 


ELSE 


GO 


ON 


C 16] 


^HALTx T=2 










Cl 7] 


VJ-4VDX 1 ( Q = n wc WAME) 










C 1 3 ] 


VECTOR DRILL 










Cl?] 


vr« { 4*X \ ( *STM € SS , /\/\'H00' )v( (SY« € « , 


+* ' ) ATYPEs 


1 M ' ) 


v ( S 


™€ '/\/V )A 




TYPEs 1 D * 










C20] 


4 VS X 1 ( S Y M g ' 1 * ) 










C21 ] 


1 RUNDRILL 2 










C 2 2 ] 


A IF FLAG INDICATES 'STOP' RESPONSE, GO 


to halt; 


ELSE 


GO 


ON 


C 2 3 ] 


4HALTxY=2 










C 2 4 ] 


vs ; 4VVX \ ( SYM S ' d>f t D ' ) A TYPE= ' M 1 










C25] 


4*x\ (SYM € * ft4r.De’ JvTYPEs'M* 










C26] 


2 RUNDRILL 1 










C273 


IF FLAG INDICATES ‘STOP 5 RESPONSE, GO 


to halt; 


ELSE 


GO 


ON 


C28] 


4HALTX Y=2 










C29] 


VVJ4KX \SYM € ' l • 










C303 


2 RUNDRILL 2 










C31 ] 


fl IF FLAG INDICATES 'STOP' RESPONSE, GO 


to halt; 


ELSE 


GO 


ON 
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[32] ->HALTxr = 2 

C333 XJ^MDx 1<0=QNC NAME) 

[34 3 MDJ4AX \ *(SYM € ‘ j> • )aTYPE='K' 

[353 1 RUN3RIL.L 3 

[363 ft Ir FLAG INDICATES ‘STOP' RESPONSE, GO TO HALT f ELSE GO ON 

[373 4 HALT X T = 2 

[333 AJQf* TEST OK • 

[393 40 

[40] HALTJCR, ‘THIS TEST HAS BEEN HALTED t 1 
7 
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? Z«-NEKTLE530N J I ; V 

[1] ftFIWD I HD EX OF LAST LESSON IN VECTOR OF LESSON NUMBERS 

[23 It-<V(. A ,MAT[ ? L ESCCL ] ) \ LAST LESSON 

[3] fiRETURN NEXT LESSON NUMBER IN SEQUENCE 

C43 2f-V[I + l] 



7 ORBERMATfOM } icom 

[13 R SORTS THE VARIABLE 'MAT' IN ACSENDING ORDER OF LESSON NUMBER 
[ 2 ] R CREATE VECTOR OF LESSON N ft 5 

[33 OMf a? MATCn43 

[4] FIND INDEXES OF LESSONS IN ORDER 

[5] ICQMf-^QM 

[£] R REORDER MAT ACCORDING TO INDEXES 

[7] mat<-mat[icom; ] 



7 Zf-SQUEEZE STRING 

[1] a CALLED BY HELP , RUN, TEACH, SHOW, SCORE, DRILL 
[23 R DELETES BLANKS IN CHARACTER STRING ARGUMENT 
[33 Z*-(‘ 1 STRING)/, STRING 

V 
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C. VARIABLES 

1 . Global v ar ia b ia s 

The following section contains all of one globa 
variables in the TUTOR workspace except the text variable 
(part C) and the user’s guide variables called by the STAR 
function (appendix A). MAT is the most important variabl 
in TUTOR, as it is called on to cross-index symbols, lassc 
numbers, function names, and selected function characteris 
tics. The variables with names ending in COL index th 
columns of MAT for use in the functions, so that thes 
columns can be rearranged if necessary. CUES provides ques 
tions for use in the ASK function, and all of the two 
letter, underlined variables (except CE) contain sets o 
multiple-choice answers for use with CUES. The other impor 
tant global variable is LASTLESSON which is given a value b 
the SHOW function to indicate the last lesson completed 
All other variables used in TUTOR functions are local vari 
ables at some level of the calling hierarchy. 
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101 

102 

103 

104 

105 

106 

107 

108 

10? 

121 

122 

123 

124 

125 

126 

127 

128 

129 

131 

132 

141 

142 

143 

144 

145 

146 

147 

143 

149 

151 

152 

161 

162 



MAT 



+ 

+ 



X 

X 



() 
I I 

ir 

f 

? 

[3 

7 

f 

\ 

/ 

/ 

* 

k 

« 

a 

G 

G 

i 

♦ 

i 

♦ 

i 

\ 

\ 

r 

L 



M 




n 




5 


t i E G A 


NEGATI VE_NUMBER 


M 




N 




A 


COHJ 


CONJUGATE 


D 


N 


N 


A 


A 


PLUS 


PLUS 


M 




M 




A 


CHAN 


CHANGERS I GM 


D 


N 


N 


A 


A 


M I N U 


MINUS 


M 




H 




A 


SIGN 


SIGNUM 


D 


H 


N 


A 


A 


TIME 


TIMES 


M 




N 




A 


RECI 


RECIPROCAL 


r« 


N 


N 


A 


A 


I* I VI 


DIVIDE 


M 




E 




A 


PARE 


PARENS 


M 




K 




V 


GUOT 


QUOTE 


D 


K 


E 


V 


A 


SPEC 


SPECIFICATION 


M 




E 




A 


SHAP 


SHAPE 


D 


M 


E 


V 


A 


RESH 


RESHAPE 


D 


E 


N 


A 


A 


BR AC 


BRACKETS 


M 




E 




A 


RAVE 


RAVEL 


D 


E 


E 


A 


A 


CATE 


CATENATE 


M 




N 




V 


INDE 


INDE a _ G E N E R ft T O R 


M 




E 




A 


RE I* 2 


REDUCTION 


M 




E 




A 


REI«1 


REDUCTION 


M 




H 




A 


EXPO 


EXPONENTIAL 


d 


N 


M 


A 


A 


POWE 


POWER 


M 




H 




A 


NATU 


H A T U R A L _ L O G 


D 


N 


N 


A 


A 


LOGA 


LOGARITHM 


M 




H 




A 


PIT I 


PI^TIMES 


r« 


H 


N 


A 


ft 


GEOM 


GEOMETRIC 


M 




H 




A 


FACT 


FACTORIAL 


D 


N 


N 


A 


A 


B I MO 


BINOMIAL 


M 




H 




A 


MAGN 


MAGNITUDE 


H 




E 




A 


SCA2 


SCAN 


M 




E 




A 


SCA1 


SCAN 


M 




H 




A 


CEIL 


CEILING 


M 




H 




A 


FLOO 


FLOOR 
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163 

164 

165 

166 

167 

168 

169 

180 

181 

182 

183 

184 

185 

191 

192 

193 

194 

195 

196 

201 

202 

203 

204 

205 

206 

211 

212 

213 

214 

215 

216 

219 

231 

232 



r 

L 

I 

6 

♦ 

? 

? 

< 

< 

> 

> 

V 

A 

A 

V 

V 

£ 

9 

» 

a 

51 

t 

; 

/ 

/ 

\ 

\ 

» 

e 

a 



D 


N 


hi 


A 


A 


MAX I 


MAXIMUM 


D 


H 


hi 


A 


A 


M I hi I 


MINIMUM 


D 


H 


N 


A 


A 


RES I 


RESIDUE 


M 




hi 




V 


G ft U P 


GRADE JJP 


M 




hi 




V 


G ft A D 


G ft A I» E _ D O W hi 


M 




H 




A 


POLL 


ROLL 


D 


M 


M 


5 


S 


DEAL 


DEAL 


D 


E 


E 


A 


A 


EGUA 


EQUAL 


D 


E 


E 


A 


A 


NOTE 


hi OT_EGUAL 


D 


N 


N 


A 


A 


LESS 


LES3_THAH 


D 


N 


hi 


A 


A 


LTEQ 


LES3_0ft_EGUAL 


D 


hi 


hi 


A 


A 


GTEQ 


GREATER_OR_EQUAL 


D 


hi 


hi 


A 


A 


GftEA 


GftEATER^THAN 


M 




B 




A 


NOT 


NOT 


D 


B 


B 


A 


A 


AND 


AND 


D 


B 


B 


A 


A 


HAND 


HAND 


D 


B 


B 


A 


A 


Oft 


OR 


D 


B 


B 


A 


A 


hi Oft 


NOR 


D 


£ 


E 


A 


A 


MEMB 


MEMBER OF 


M 




E 




A 


ftEV2 


REVERSE 


M 




E 




S 


RE V i 


REVERSE 


D 


hi 


E 


A 


A 


S:OT2 


ROTATE 


D 


hi 


E 


A 


A 


ft'OT 1 


ROTATE 


M 




E 




A 


TRAM 


TRANS POSE -MONADIC 


D 


N 


E 


V 


A 


TRAD 


TRANSPOSE-DYADIC 


D 


hi 


E 


V 


A 


TAKE 


TAKE 


D 


N 


E 


V 


A 


DROP 


DROP 


D 


B 


E 


V 


A 


COM2 


COMPRESS 


D 


B 


E 


V 


A 


C OM 1 


COMPRESS 


D 


B 


E 


V 


A 


EXP 2 


EXPAND 


d 


B 


E 


V 


A 


EXP1 


EXPAN D 


D 


E 


E 


A 


A 


LAMI 


LAMINATE 


M 




hi 




% / 


MAT I 


M A T R I X _ I hi V E ft 5 E 


D 


hi 


hi 


X 


W 
/ % 


MATD 


MATRIX_DI VIDE 
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241 


* ♦ 


D 


E 


242 


• 


D 


E 


301 


\ 


D 


E 


304 


T 


D 


N 


305 


± 


D 


N 


306 


l 


M 




307 


t 


D 


H 


308 


t 


M 





E 


A 


A 


OUTE 


E 


A 


A 


IN ME 


E 


V 


A 


INDO 


H 


A 


A 


EMCO 


H 


A 


A 


DECO 


K 




V 


EXEC 


N 


V 


A 


D YFO 


E 




A 


FORM 



0 U T £ ft _ P ft 0 P U C T 

INMER_F RODUCT 

IND£X_OF 

ENCODE 

DECODE 

EXECUTE 

FORMAT-DYADIC 

FORMAT-MONADIC 
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LESCOL 



12 3 4 



S T M C 0 L 



8 



MI'COL 



12 



MKCOL 



16 13 



SVXACOL 

22 24 



MAMECOL 

23 2 ? 30 31 



FNAMECOL 

35 36 37 33 3 ? 40 41 42 43 44 45 46 47 43 49 50 51 
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CUES 



1 HOW MANY ARGUMENTS DOES THE ‘,FNAME,« FUNCTION TAKE?* 

•DOES SI 1 j 5 Y M , 1 SO EQUAL - 2 ' y STM j 1 -• 1 ? 1 

‘IF ONE ARGUMENT IS A VECTOR, THE OTHER ARGUMENT MAY BE SCALAR OR VECTOR 

♦ (T/F)* 

‘IF ONE ARGUMENT IS A MATRIX, THE OTHER ARGUMENT MUST BE A SCALAR*, CR , * 
OR A MATRIX OF THE SAME SHARE 4 (T/F)* 

‘WHAT RANK CAN THE LEFT ARGUMENT OF ' , FN AM E , 1 BE? 1 , R K 

‘WHAT RANK CAN THE RIGHT ARGUMENT OF 1 , F N A M E , 1 BE?' ,RK 

‘DO THE ARGUMENTS ALWAYS HAVE TO HAVE THE SAME RANK?* 

‘CAN 1 , F N A M E , ' TAKE CHARACTER ARGUMENTS?* 

‘IF SO, WHICH ARGUMENT ( 5 ) CAN BE CH ARAC T ER ? • ? Aft 

‘DOES 1 , F N A M E , ' TAKE BOOLEAN (1 OR 0) ARGUMENTS? * 

‘IF SO, WHICH ARGUMENT ( S ) MUST BE BOOLEAN?', AR 

♦ 2 * 

ENTER R FOR RIGHT, 

L FOR LEFT, OR 
B FOR BOTH 
♦ £!< 

ENTER S FOR SCALAR 
V FOR VECTOR 
X FOR MATRIX 
A FOR. ANY RANK 
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Text variables 



2 . 

The following global variables contain the basic 
text of the TUTOR course. They are printed in the same 
order as the lessons. The header above each variable is r.ot 
part of the text; it lists the lesson number, the short 
title of the variables, and the fall name of the function. 
The first column control characters are omitted here. 
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101 



NEGATIVE NUMBER 



MEGA 



♦ ♦♦♦*♦•******♦**«♦♦♦♦♦♦*♦♦♦*♦♦♦ ♦***♦*♦♦*♦♦♦♦♦♦♦♦♦*♦*♦*♦*♦♦♦♦♦ 
THE SYMBOL “ (UPSHIFT 2) 15 USED ONLY TO ENTER NEGATIVE NUMBERS, 

IT CAN BE USED ONLY IN FRONT OF SCALARS (SINGLE NUMBERS), 

HOT VARIABLE NAMES, ARITHMETIC EXPRESSIONS, OR ARRAYS, 

TO CHANGE ARITHMETIC SIGN USE THE SYMBOL - (UPSHIFT +), 



74 



102 



CONJUGATE 



CGNJ 



♦*♦♦*♦♦♦*♦•**♦♦**•♦*♦♦*****•♦**♦+****♦******♦♦*♦*•*•*♦♦*♦♦»♦•*♦**♦♦ 
THE SYMBOL + IS USED FOR THE MONADIC CONJUGATE FUNCTION , 

THIS IS AN IDENTITY FUNCTION WHICH RETURNS ITS ARGUMENT r AFTER 

EVALUATION IF NECESSARY f IT TAKES NUMERIC ARGUMENTS OF ANY RANK 

example; +2 => 2 +‘3+2 => ‘1* 
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PLUS 



PLUS 



******************************* + *********************************** 
THE SYMBOL + IS USED FOR THE DYADIC PLUS FUNCTION, 

THIS PERFORMS SIMPLE ADDITION ON NUMERIC ARGUMENTS OF ANY RANK, 

FOR EXAMPLE* 2+2 => 4 SPACING IS NOT IMPORTANT, 

TO ADD A SCALAR TO EACH ELEMENT OF A VECTOR, ENTER EITHER S-fV OR V + 3 , 
V1+V2 WILL ADD TWO VECTORS ELEMENT BY ELEMENT # FOR EXAMPLE ♦ 

2+ ( 3 4 5) => 5 6 7 (34 5>+2 = > 567 

(3 4 5 ) + ( 5 6 7) => 8 10 12 

IF THE TWO VECTORS BEING ADDED ARE NOT THE SAME LENGTH, 

YOU WILL GET A 'LENGTH ERROR 1 , 

MATRIX ADDITION IS DONE AS FOLLOWS: 

S+M OR M+S WILL ADD THE SCALAR S TO EACH ELEMENT OF THE MATRIX M + 

FOR EXAMPLE* IF M => 12 THEN 3+M = > 4 5 AND M+3 =>45 

3 4 6 7 6 7 

M1+M2 WILL ADD THE MATRIX Ml TO THE MATRIX M2, ELEMENT BY ELEMENT, 

FOR EXAMPLE* IF Ml => 1 2 AND M2 = > 3 4 THEM M 1 + M 2 => 4 6 

3 4 5 6 3 10 

Ml AND M2 MUST BE THE SAME SHAPE OR A ‘LENGTH ERROR' WILL RESULT, 
TRYING TO ADD A VECTOR TO A MATRIX WILL RESULT IN A 'RANK ERROR', 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 
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CHANGE SIGN 



C H A N 



THE SYMBOL - (UPSHIFT +) IS USED FOP: THE MONADIC CHANGE SIGN FUNCTION, 
THIS CHANGES THE ARITHMETIC SIGN OF ITS NUMERIC ARGUMENT OF ANY RANK, 

FOR example; -(1 *"2 3) = > ”1 2 ~3* 

NOTE THE DIFFERENCE BETWEEN - AND *“ (UPSHIFT 2)> WHICH INDICATES 
NEGATIVE NUMBERS , 
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MINUS 



MI MU 



THE SYMBOL - (UPSHIFT + ) IS USEE FOR THE DYADIC MINUS FUNCTION , 

IT PERFORMS SIMPLE SUBTRACTION ON NUMERIC ARGUMENTS OF ANY RANK, 

FOR example; 5-2 => 3 “10-~2 => “3 

TO SUBTRACT A SCALAR FROM EACH ELEMENT OF A VECTOR, ENTER V-S , 

TO SUBTRACT EACH ELEMENT OF A VECTOR FROM THE SAME SCALAR, ENTER S-V 
V1-V2 WILL SUBTRACT EACH ELEMENT OF V2 FROM THE CORRESPONDING 
ELEMENT OF VI, 

VI AND V2 MUST BE THE SAME LENGTH OR YOU WILL GET A 'LENGTH ERROR', 

FOR example; (3 4 5)-2 => 123 2- ( 3 4 5) => '1 "2 "3 

(6 7 S)-(l 23) => 555 

ENTER M-S TO SUBTRACT THE SCALAR S FROM EACH ELEMENT OF THE MATRIX M 
ENTER S-M TO DO THE OPPOSITE, 

for example; if m => 1 2 then 4~m = > 32 and m-2 = > "1 0 

3 4 10 12 

M1-M2 SUBTRACTS MATRIX M2 FROM MATRIX Mi, ELEMENT BY ELEMENT, 

FOR example; IF Ml => 1 2 AND M2 => 3 4 THEN M2~ M 1 => 22 

3 4 5 6 2 2 

IF Ml AND M2 ARE NOT THE SAME SHAPE, A 'LENGTH ERROR' WILL RESULT, 

TRYING TO SUBTRACT A VECTOR FROM A MATRIX OR VICE-VERSA WILL 
PRODUCE A 'RANK ERROR', 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 
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SIGNUM 



SIGN 



THE SYMBOL X IS USED FOF: THE MONADIC 5IGHUM FUNCTION, 

IT RETURNS THE ARITHMETIC SIGN OF THE ARGUMENT ♦ l FOR POSITIVE 
“1 FOR NEGATIVE NUMBERS , AND 0 F0R ZERO VALUES, 

IT TAKES NUMERIC ARGUMENTS OF ANY RANK, 

FOR example; x ( 3 “2> => 1 "1 x(3+2-5) = > 0 



NUMBERS 7 



7 ? 
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TIMES 



I ME 



♦ ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦*♦♦♦♦♦♦♦♦ X ♦♦♦♦♦*♦♦♦♦♦♦♦»♦♦»♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦♦♦ 
THE SYMBOL X 15 USED FOR THE DYADIC TIMES FUNCTION, 

THIS PERFORMS SIMPLE MULTIPLICATION ON NUMERIC ARGUMENTS OF ANY RANK, 

FOR EXAMPLE J 2X^ => 3 ORDER AND SPACING ARE NOT IMPORTANT, 

TO MULTIPY EACH ELEMENT OF A VECTOR BY A SCALAR f ENTER SxV OR VxS, 
V1XV2 RESULTS IN THE PRODUCT OF CORRESPONDING ELEMENTS OF VI AND V2, 

FOR example; 3x(1 2 3) =>369 (1 2 3)x3 => 369 

(1 2 3 ) x ( 2 4 6) => 2 3 13 

IF VI AND V2 ARE NOT THE SAME LENGTH, YOU WILL GET A 'LENGTH ERROR', 

EITHER M X 5 OR SxM WILL MULTIPLY A MATRIX BY A SCALAR, 

THE RESULT WILL BE A MATRIX THE SAME SHAPE AS M, 

FOR EXAMPLE; IF M r> 1 2 THEN 3XM =>36 Wx3 =>36 

3 4 9 12 9 12 

M 1 X M2 WILL RETURN THE PRODUCT OF CORRESPONDING ELEMENTS IN Mi AND M2, 
Mi AND M2 MUST BE THE SAME SHAPE OR YOU WILL GET A 'LENGTH ERROR', 
FOR EXAMPLE; IF Mi => 1 2 AND M2 = > 3 4 THEN MlxM2 =>33 

34 56 15 24 

IT IS IMPORTANT TO NOTE THAT MULTIPLYING MATRIXES WILL NOT RESULT IN 
'MATRIX MULTIPLICATION' (INNER PRODUCT OR DOT PRODUCT), 

FOR INFORMATION ON INNER PRODUCT , REQUEST HELP ON (DOT OR PERIOD), 

MULTIPLYING A VECTOR WITH A MATRIX WILL RESULT IN A 'RANK ERROR', 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 
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10S 



RECIPROCAL 



RFC J 



♦ ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦if********** • ********************************** 

THE SYMBOL (UPSHIFT x) IS USED FOR THE MONADIC RECIPROCAL FUNCTION 
THIS RETURNS THE RESULT OF 1 DIVIDED BY THE ARGUMENT , 

ITS ARGUMENT MUST BE NUMERIC AND CAN BE OF ANY RANK, 

HOWEVER f IF THE ARGUMENT HAS VALUE Q ? A ’DOMAIN ERROR’ WILL RESULT, 

FOR example: t(1 2 3) => 1 0 ♦ 5 0*333333333 
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DIVIDE 



D I V I 



♦ ♦♦♦♦♦♦ + ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦* ” ♦ ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦**♦♦♦♦♦ 
THE SYMBOL ^ (UPSHIFT X) IS USED FQF: THE DYADIC DIVISION FUNCTION, 

IT PERFORMS SIMPLE DIVISION ON NUMERIC ARGUMENTS OF ANY RANK , 

FOR EXAMPLE J 6^2 => 3 ~10t’4 => 2*5 

DIVIDING BY 0 RESULTS IN A 'DOMAIN ERROR', EXCEPT THAT Q-rO => i, 

TO DIVIDE A SCALAR BY EACH ELEMENT OF A VECTOR, ENTER S-V, 

TO DIVIDE EACH ELEMENT OF A VECTOR BY THE SAME SCALAR, ENTER V-3, 

VI t VO DIVIDES EACH ELEMENT OF VI BY THE CORRESPONDING ELEMENT OF V2 ♦ 
VI AND V2 MUST BE THE SAME LENGTH OR YOU WILL GET A 'LENGTH ERROR', 

FOR example; (3 4 5)^*2 = > 1*5 2 2*5 3r(3 4 5) => 1 *75 *6 

(3 6 9 )*(l 23) => 333 

ENTER S-M TO DIVIDE THE SCALAR S BY EACH ELEMENT OF THE MATRIX M, 

MrS WILL DIVIDE EACH ELEMENT OF M BY S, BOTH OPERATIONS RESULT IN 
A MATRIX THE SAME SHAPE AS M, 

for example; if m => 12 then 2 ^ m => 2 1 and m -^2 = > 0*5 1 

4 5 0*5 0*4 2 2* 

M 1 -i* M2 DIVIDES MATRIX Ml BY MATRIX M2, ELEMENT BY ELEMENT, 

FOR example; IF Ml => 2 4 AND M2 => 1 2 THEN Ml^-M2 => 2 2 

6 8 3 4 2 2 

IF Ml AND M2 ARE NOT THE SAME SHAPE, A 'LENGTH ERROR' WILL RESULT, 
TRYING TO DIVIDE A MATRIX BY A VECTOR OR VICE-VERSA WILL PRODUCE A 
'RANK ERROR', 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 
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PARENS 



PARE 



() 

PARENTHESES ARE USED TO GROUP SYMBOLS FOR CORRECT PROCESSING BY 

THE APL INTERPRETER , 

APL DIFFERS FROM EVERY OTHER COMPUTER LANGUAGE IN THE WAY IT 
DETERMINES WHICH OPERATION IS PERFORMED FIRST, 

IT SIMPLY READS FROM RIGHT TO LEFT — 1 BACKWARDS * — AND PERFORMS EACH 



OPERATION AS IT GOES ALONG, 

for example; 3x2+1 => ? 


BECAUSE 


2+1 


= > 


3 


AND 


3x3 => 


9 


1+2x3 = > 7 


BECAUSE 


2x3 


= > 


6 


AND 


1+6 => 


"7 

/ 



PARENTHESES ARE 


USED TO 


OVERRIDE THIS 


RIGHT-TO-LEFT RULE, 


FOR example; 


(3x2)+i 


= > 7 AND 


( 1+2) x3 => 9 



EXPRESSIONS WITHIN PARENTHESES ARE EVALUATED FIRST — 

ALSO FROM RIGHT TO LEFT , 

USING THE RIGHT-TO-LSFT RULE CAN ELIMINATE PARENTHESES, 

BUT USING PARENTHESES GENEROUSLY CAN ELIMINATE CONFUSION, 
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QUOTE 



QUOT 



THE QUOTE HARK • (UPSHIFT K) IS USED TO EMCLOSE CHARACTER DATA, 

APL ASSUMES THAT LETTERS (OR COMBINATIONS OF LETTERS AND NUMBERS) 

ARE VARIABLE OR FUNCTION NAMES UNLESS THEY ARE ENCLOSED IN QUOTES 



FOR EXAMPLE ; 


IN THIS TUTORIAL, 


HOW - > 


(THE VARIABLE NAMED HOW) 


•HOW => 


HOW 



YOU CAN ALSO USE SYMBOLS AND NUMBERS AS CHARACTER DATA , 
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SPECIFICATION 



SPEC 



♦ ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦♦♦*♦♦♦ B ♦♦*♦♦*♦♦♦♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦#♦♦♦ 

THE SYMBOL 4* IS USED FOR SPECIFICATION, 

IT ASSIGNS THE VALUE OF THE RIGHT ARGUMENT TO THE VARIABLE NAME 
WHICH IS THE LEFT ARGUMENT, 

THE VARIABLE NAME CAN BE ANY COMBINATION OF LETTERS AND NUMBERS (NO 
SYMBOLS AND NO SPACES) WHICH BEGINS WITH A LETTER, LENGTH IS 
EFFECTIVELY UNLIMITED, 

THE RIGHT ARGUMENT CAN BE EITHER CHARACTER OR NUMERIC, OF ANY RANK , 
TO SPECIFY A CHARACTER VARIABLE, ENCLOSE THE RIGHT ARGUMENT IN 
SINGLE QUOTES (') UNLESS IT IS ANOTHER CHARACTER VARIABLE, 



NOTE THAT THE VARIABLE CAN BE USED IN THE SAME LINE AS THE VALUE IS 
SPECIFIED, FOR EXAMPLE * 

Ni-2 + Yf 2 RESULTS IN X HAVING VALUE 2 AMD Y HAVING VALUE 5 
X^YfZfl RESULTS IN. X, Y, AND Z ALL HAVING VALUE 1 

2 3 RESULTS IN V HAVING VECTOR VALUE (} 2 3 > 

Vlf-'APL' RESULTS IN Vi BEING A CHARACTER VECTOR; APL 

V 2 f V 1 RESULTS IN V2 BEING A CHARACTER VECTOR; APL 



SEE HELP OH j> (UPSHIFT ft ) FOR INFORMATION ON SPECIFYING MATRIJ 
VARIABLES , 
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SHAPE 



SNAP 



*♦*♦♦♦♦*♦♦♦♦♦*♦♦♦*♦*♦♦***♦***♦♦ ? ♦ ♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦*♦♦*♦♦*♦♦♦*♦♦♦♦ 

THE SYMBOL f 15 USED F r OR THE MONADIC SHAPE FUNCTION, 

THIS RETURNS A DESCRIPTION OF THE SIZE OF ITS ARGUMENT, WHICH CAN 
BE NUMERIC OR CHARACTER, OF ANY RANK , 

THE SYMBOL CAM BE USED TWICE (ffA) TO RETURN THE RANK OF ITS ARGUMENT , 

IF THE ARGUMENT IS A SCALAR, f 5 RETURNS NO NUMBER (AN EMPTY VECTOR) ? 
BECAUSE A SCALAR HAS NO DIMENSION, ffS => Q 

ENTERING f V RETURNS ONE NUMBER WHICH REPRESENTS THE LENGTH OF 

THE VECTOR'S ONE DIMENSION, ffV => 1 

THE SHAPE OF MATRIXES IS EXPRESSED AS A TWO-ELEMENT VECTOR, 

THE FIRST ELEMENT EQUALS THE NUMBER OF ROWS (THE LENGTH CF THE 
FIRST DIMENSION), AND THE SECOND ELEMENT EQUALS THE NUMBER OF 
COLUMNS (THE LENGTH OF THE SECOND DIMENSION), 

FOR EXAMPLE; IF M => 1 2 3 THEN *M => 2 3 AND f f M => 2 

4 5 £ 

FOR HIGHER-LEVEL ARRAYS, f A WILL RE A VECTOR WITH AS MANY ELEMENTS AS 
A HAS DIMENSIONS, THE HUMBER OF COLUMNS WILL ALWAYS BE THE LAST 
ELEMENT OF fA, THE NUMBER OF ROWS WILL ALWAYS BE THE HEX T -TO -L A S T 
ELEMENT, PRECEDED BY THE NUMBER OF 'PAGES' OR PLANES, PRECEDED BY 
THE NUMBER OF 'BOOKS' OR SPACES, AND SO ON, 

FOR EXAMPLE; IF D IS A 4-BIMEHSIOHAL ARRAY, />fD => 4, 

IF />!'=> 5342 THEN D HAS 5 BOOKS, EACH WITH 3 PAGES, EACH OF 

WHICH HAS 4 ROWS AND 2 COLUMNS, (THIS WOULD BE DISPLAYED AS 

FIFTEEN SUCCESSIVE 4x2 MATRIXES THE FIRST THREE BEING THE FIRST 

BOOK, THE SECOND THREE BEING THE SECOND BOOK, ETC,) 
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RESHAPE 



RESH 



♦ ♦*♦♦***♦♦♦*♦*♦♦♦♦*♦♦**♦♦**♦♦*♦ / ♦***♦*♦♦*♦♦♦♦*♦♦*♦♦♦♦******♦♦♦♦♦**♦ 
THE SYMBOL f IS USED FOR THE DYADIC RESHAPE FUNCTION, 

THIS TAKES THE ELEMENTS OF THE RIGHT ARGUMENT AND REARRANGES THEM 
ACCORDING TO THE SHAPE SPECIFIED BY THE LEFT ARGUMENT, 

THE LEFT ARGUMENT MUST BE AN INTEGER SCALAR OR A VECTOR OF INTEGER 
ELEMENTS , 

THE RIGHT ARGUMENT CAN BE NUMERIC OR CHARACTER, OF ANY RANK, 

IF THE LEFT ARGUMENT IS A SCALAR, THE RESULT WILL BE A VECTOR WITH 

LENGTH EQUAL TO THE SCALAR, CONSISTING OF THE ELEMENTS OF THE RIGHT 
ARGUMENT, TAKEN IN ORDER TOP LEFT TO BOTTOM RIGHT, 

WHEN THERE ARE NOT ENOUGH ELEMENTS IN THE RIGHT ARGUMENT, 

THE FUNCTION WILL START OVER AND TAKE THE ELEMENTS IN ORDER AGAIN, 
AS MANY TIMES AS NECESSARY TO FILL THE VECTOR, 

FOR EXAMPLE; 1 => 1111 

4 f ( ' A B ‘ ) -> ABAB 

IF THERE ARE TOO MANY ELEMENTS OH THE RIGHT, THE EXTRAS ARE OMITTED, 

for example; 2/(1 23 4) => 1 2 

IF THE LEFT ARGUMENT IS A VECTOR, THE ELEMENTS INDICATE, IN ORDER, 
LENGTH OF EACH DIMENSION IN THE RESULT, 

for example; 22/1234 => 12 

3 4 

THIS IS ONE WAY TO ENTER MATRIXES OR ARRAYS OF HIGHER DIMENSION, 

USING A MATRIX OR HIGHER-LEVEL ARRAY AS THE LEFT ARGUMENT OF RESHAPE 
WILL RESULT IN A ‘RANK ERROR', 
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BRACKETS 



BRAG 
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DYADIC SQUARE BRACKETS ARE USED TO INDEX THE ELEMENTS OF AN ARRAY, 

THEY CAN BE THOUGHT OF AS ENCLOSING SUBSCRIPTS, 

THE LEFT ARGUMENT (LEFT OF THE BRACKETS) CAN BE A NUMERIC OR CHARACTER- 
ARRAY OF ANY RANK, BUT NOT A SCALAR, INDEXING A SCALAR WILL RESULT 
IN A 'RANK ERROR 1 , 

THE RIGHT ARGUMENT (BETWEEN THE BRACKETS) MUST BE ONE OR MORE 

INTEGER SCALARS OR VECTORS, SEPARATED BY SEMICOLONS (}), THERE 
MUST BE AS MANY SC AL ARS/ VEC TORS AS THERE ARE DIMENSIONS IN THE 
LEFT ARGUMENT, OR A 'RANK ERROR* WILL. RESULT, 

ANY NUMERIC EXPRESSIONS WITHIN THE BRACKETS WILL BE EVALUATED AS IF 
THE BRACKETS AND SEMICOLONS ARE PARENTHESES, 

BRACKETS CAN ALSO BE USED FOLLOWING THESE SYMBOLS* ,/\/V$© 

FOR MORE INFORMATION, SEE HELP ON THE APPROPRIATE SYMBOL, 



FOR EXAMPLE; IF V IS A VECTOR WITH VALUE (Z A 5 6) y 

V C1] = > 2 v C 1 2] => 3 4 vci+ 23 => 5 v[i]+v[2] => 7 

* A PROGRAMMING LANGUAGE £ 3 15] => APL 

THERE IS ONLY ONE SCALAR OR VECTOR WITHIN THE BRACKETS BECAUSE 
VECTORS HAVE ONLY ONE DIMENSION, 



MATRIXES REQUIRE TWO SUBSCRIPTS — TWO SCALARS OR VECTORS, SEPARATED 
Bi A SEMICOLON( } ) , WITHIN THE BRACKETS, 

THE FIRST SUBSCRIPT REFERS TO THE ROW, THE SECOND TO THE COLUMN, 

for example; if m => 123 then M[i;i] => i and m[i 3523 => 23 

4 5 6 
7 3? 

TO SELECT AN ENTIRE ROW (OR ROWS), ENTER THE ROW SUBSCRIPT FOLLOWED 
BY 6 SEMICOLON, WITH NO COLUMN SUBSCRIPT, 

for example; m[ij] => 123 

FOR ENTIRE COLUMN(S), LEAVE THE ROW SUBCRIPT BLANK AND ENTER A SEMI- 
COLON FOLLOWED BY THE COLUMN SUBSCRIPT (S) , 
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FOR: EXAMPLE* IF Ml FOR: THEM M 1 [ ,* 1 ] = > F Y I 

YOUR: 

INFO 

NOTICE THAT ONE ROW OR: ONE COLUMN OF A MATRIX IS SIMPLY A VECTOR, 
NOT A IxC OR: R: x 1 MATRIX , A SINGLE ELEMENT OF A MATRIX IS A 
SCALAR, NOT A 1x1 MATRIX OR; A VECTOR: OF LENGTH 1, 



THE USE OF BRACKETS CAN BE EXTENDED TO HIGHER: DIMENSIONS BY ADDING 
A SEMICOLON AND A SCALAR OR: VECTOR: FOP: EACH DIMENSION, 

FOP: EXAMPLE, IF f M => 2 3 4 5? THE SECOND BOOK, THIRD PAGE, FIRST 

(ALL COLUMNS) CAN BE SELECTED BY ENTERING M[2J3ii;] t 



ROW 
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PAVEL 



RAVE 



THE SYMBOL , IS USED FOR THE MONADIC RAVEL FUNCTION , 

THIS FUNCTION CHANGES ITS ARGUMENT TO THE FORM OF A VECTOR, IT TAKES 
EITHER NUMERIC OR CHARACTER ARGUMENTS OF ANY RANK, 

TO CHANGE A SCALAR TO A VECTOR OF LENGTH 1, ENTER , S , 

FOR EXAMPLE: * f A 3 => 0 *UT Ffl 3 => 1 

THIS CAN BE USEFUL TO ENSURE THAT A VARIABLE IS A VECTOR WHEN 
USING A SCALAR WOULD LEAD TO AN ERROR ( E , G , . INDEXING), 

VECTORS REMAIN UNCHANGED BY RAVELLING, 

MATRIXES ARE CHANGED INTO A SINGLE LONG VECTOR f STARTING WITH THE 
TOR ROW AND READING ACROSS EACH ROW FROM LEFT TO RIGHT, 

for example; if mi =>12 then , mi => 1234 

3 4 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 
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CATENATE 



CATE 



-inn 

1 w 



THE SYMBOL , IS USED FOR THE DYADIC CATENATE FUNCTION, 

THIS FUNCTION WILL COMBINE TWO SCALARS OR ARRAYS INTO A SINGLE ARRAY , 
IT TAKES EITHER NUMERIC OR CHARACTER ARGUMENTS, 

ENTERING SI ,52 WILL RESULT IN A VECTOR (SI S 2 ) ♦ FOR EXAMPLE \ 

Vf 1 , 2 WILL ASSIGN THE VECTOR VALUE (1 2) T0 THE VARIABLE V, 

VECTORS CAN EASILY BE EXTENDED BY CATENATING S, V OR V 7 S OR V , V + 

FOR EXAMPLEJ IF V => 12 THEN 

v,3 => 123 0 »v => 012 v f v => 1212 

CATENATING A SCALAR TO A MATRIX WILL RESULT IN A MATRIX WITH 

ONE MORE COLUMN THAN T HE MATRIX ARGUMENT, ALL ENTRIES IN THIS 
COLUMN WILL HAVE THE VALUE OF THE SCALAR, FOR EXAMPLE; 

IF M => 1 2 THEN 5,M => 512 AND M,5 => 125 

3 4 5 3 4 3 4 5 

CATENATING TWO MATRIXES WILL RESULT IN A MATRIX CONTAINING THE TWO 
ORIGINAL MATRIXES 'SIDE BY SIDE', 

BOTH MATRIXES MUST HAVE THE SAME NUMBER OF ROWS OR A 'LENGTH ERROR' 
WILL RESULT, 

for example; if mi => 12 and M2 => 5 d 

3 4 7 3 

THEN Ml, M2 => 12 5 6 AND M2, mi = > 5612 

3 4 7 3 7 8 3 4 

TRYING TO CATENATE A VECTOR TO A MATRIX WILL RESULT IN A 'RANK ERROR', 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 

FOR MORE INFORMATION ON DIFFERENT WAYS TO JOIN ARRAYS, SEE 
MENU FOR LAMINATE, 



?1 



12 ? 



INDEX GENERATOR 



INDE 



THE SYMBOL \ (UPSHIFT I) IS USE I* FOR THE MONADIC INDEX GENERATING 
FUNCTION # 

IT 15 USED WITH A SINGLE NON-NEGATIVE INTEGER ARGUMENT (SCALAR, OR 
VECTOR OF LENGTH 1), 

IT RETURNS A VECTOR OF INTEGERS, IN ORDER, BEGINNING WITH THE INDEX 
ORIGIN, AND ENDING WITH THE ARGUMENT* 

FOR EXAMPLE * \Z => 123 lO => (AN EMPTY VECTOR) 

THE INDEX ORIGIN IS NORMALLY (BY DEFAULT) 1* 

USING \ WITH A NON-INTEGER, NEGATIVE OR ARRAY ARGUMENT WILL PRODUCE A 
1 DOMAIN ERROR 1 * 
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REDUCTION 



REDO 



*•♦*♦**♦*•*♦♦**♦***♦♦♦♦♦♦♦•♦**♦ / ♦ ♦♦♦♦♦♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦♦♦ 
THE SYMBOL / IS USED FOLLOWING ANOTHER FUNCTION SYMBOL AND 

PRECEDING A SINGLE ARGUMENT TO PRODUCE THE MIKED FUNCTION 
CALLED REDUCTION, 

REDUCTION MAY BE USED WITH NUMERIC ARGUMENTS OF ANY RANK, 

REDUCTION MAY ALSO BE USED WITH CHARACTER ARGUMENTS IF THE FUNCTION 
IT IS BEING COMBINED WITH ACCEPTS CHARACTER ARGUMENTS, 

USING / WITH A SCALAR SIMPLY RETURNS THE SCALAR, 

WHEN USED WITH A VECTOR , REDUCTION GIVES THE SAME EFFECT AS INSERTING 
THE OTHER FUNCTION SYMBOL BETWEEN EACH VALUE OF THE VECTOR, 

FOR example; 

+ /( 1 2 3) = > 6 because i+2 + 3 => 6 

x / ( 2 3 4> => 24 because 2X3X4 => 24 

WHEN USING REDUCTION, ALWAYS REMEMBER APL READS RIGHT TO LEFT,* 

-/(l 2 3) => 2 BECAUSE 1- ( 2-3 ) => 2 

(NOTICE THIS PRODUCES THE EFFECT OF SUMMATION WITH ALTERNATING SIGNS,) 

WHEN USED WITH A MATRIX, / WILL PERFORM AS IF EACH COLUMN IS 

A UNIT, IT WILL ADD THE CORRESPONDING ELEMENTS OF EACH COLUMN, 

SO THAT THE ANSWER WILL BE A VECTOR WITH AS MANY ELEMENTS AS 
THERE WERE ROWS IN THE ARGUMENT, 

FOR EXAMPLE* IF fM => 2 4 THEN f +/M => 2 

APL USERS REFER TO THIS AS WORKING 'ACROSS' OR 'OVER' THE COLUMNS, 
SINCE COLUMNS ARE THE SECOND OF TWO DIMENSIONS OF A MATRIX, 

THIS MEANS THAT THE SYMBOL / WORKS 'OVER' THE LAST DIMENSION, 

TO REDUCE OVER THE FIRST DIMENSION ( E , G , ROWS OF A MATRIX), USE THE 
SYMBOL f (ALT /), IN PLACE OF /, 

THIS IS IMPORTANT WHEN WORKING WITH HIGHER-DIMENSIONAL ARRAYS, 

FOR EXAMPLE, IN A THREE-DIMENSIONAL ARRAY OF FAGES, ROWS, AND 
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COLUMNS, / WILL REDUCE OVER THE COLUMNS, / OVER THE PAGES, 

TO REDUCE OVER ANY DIMENSION, YOU MAY SPECIFY THE DIMENSION IN 
BRACKETS FOLLOWING THE + (OR THE /) SYMBOL, 

FOR EXAMPLE , TO PLUS REDUCE OVER THE ROWS OF A THREE-DIMENSIONAL 
ARRAY CALLED AA, ENTER +/[2]AA or +/C2] fiA * T0 PLUS REDUCE 
OVER THE PAGES, ENTER + /AA OR +/[1]AA, TO PLUS REDUCE OVER 
THE COLUMNS, ENTER +/AA OR +/[3]AA, 

THE SHAPE OF THE ANSWER WILL ALWAYS BE THE SAME AS THE SHAPE OF THE 
ARGUMENT OMITTING THE DIMENSION REDUCED OVER, 

FOP EXAMPLE J IF fA = > 3 4 5 



"7 



r+/E2]« => 3 5 



THEN 



F+/* 



— / 



4 



f+/A =>45 
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REDUCTION 



r e r« i 



♦ ♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦» + <**♦*♦♦♦♦♦ T ♦ ♦♦♦♦♦•*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦♦♦♦ 
THE SYMBOL / (ALT /) IS USED FOLLOWING ANOTHER FUNCTION SYMBOL AND 

PRECEDING A SINGLE ARGUMENT TO PRODUCE THE MINED FUNCTION 
CALLED REDUCTION, 

REDUCTION MAY BE USED WITH NUMERIC ARGUMENTS OF ANY RANK, 

REDUCTION MAY ALSO BE USED WITH CHARACTER ARGUMENTS IF THE FUNCTION 

IT IS BEING COMBINED WITH ACCEPTS CHARACTER ARGUMENTS, 

USING / WITH A SCALAR SIMPLY RETURNS THE SCALAR, 

WHEN USED WITH A VECTOR , REDUCTION GIVES THE SAME EFFECT AS INSERTING 
THE OTHER FUNCTION SYMBOL BETWEEN EACH VALUE OF THE VECTOR, 

FOR example; 

+ /(1 2 3) => 6 BECAUSE 1 + 2 + 3 => 6 

x /(2 3 4 ) => 24 because 2 * 3 x 4 => 24 

WHEN USING REDUCTION, ALWAYS REMEMBER APL READS RIGHT TO LEFT; 

-/(l 23) => 2 BECAUSE 1- (2-3) => 2 

(NOTICE THIS PRODUCES THE EFFECT OF SUMMATION WITH ALTERNATING SIGNS,) 

WHEN USED WITH A MATRIX, / WILL PERFORM AS IF EACH ROW IS 

A UNIT, IT WILL ADD THE CORRESPONDING ELEMENTS OF EACH ROW, 

SO THAT THE ANSWER WILL BE A VECTOR WITH AS MANY ELEMENTS AS 
THERE WERE COLUMNS IN THE ARGUMENT, 

for example; if f m => 24 then p+/m => 4 

APL USERS REFER TO THIS AS WORKING ' ACROSS ’ OR 'OVER 1 THE ROWS, 

SINCE ROWS ARE THE FIRST OF TWO DIMENSIONS OF A MATRIX, 

THIS MEANS THAT THE SYMBOL / WORKS 1 OVER 1 THE FIRST DIMENSION, 

TO REDUCE OVER THE LAST DIMENSION ( E , G , COLUMNS OF A MATRIX), USE THE 
SlKBOL / IN PLACE OF /, 

THIS IS IMPORTANT WHEN WORKING WITH HIGHER— DIMENSIONAL ARRAYS, 

FOR EXAMPLE, IN A THREE-DIMENSIONAL ARRAY OF PAGES, ROWS, AND 
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COLUMNS, / WILL REDUCE OVER THE COLUMNS, / OVER THE PAGES, 

TO REDUCE OVER ANT DIMENSION, YOU MAY SPECIFY THE DIMENSION IN 
BRACKETS FOLLOWING THE / (OR THE /) SYMBOL, 

FOR EXAMPLE, TO PLUS REDUCE OVER THE ROWS OF A THREE-DIMENSIONAL 
ARRAY CALLED A A 9 ENTER + /T2]AA OR -l/[2]AA, TO PLUS REDUCE 
OVER THE PAGES, ENTER +/AA OR +/£ 1 ]AA, TO PLUS REDUCE OVER 
THE COLUMNS, ENTER +/AA OR +/[T]AA, 

THE SHAPE OF THE ANSWER WILL ALWAYS BE THE SAME AS THE SHAPE OF THE 
ARGUMENT OMITTING THE DIMENSION REDUCED OVER, 

for example; if f a => 345 

THEN f+/A => 45 f+/C2JA => 35 f+/A => 34 
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♦ ♦***♦♦♦***♦*♦**♦***♦♦**♦*#♦♦** ^ 

THE SYMBOL * (UPSHIFT P) IS USED FOR THE MONADIC EXPONENTIAL FUNCTION, 
IT RETURNS THE VALUE OF THE CONSTANT E TO THE POWER OF THE ARGUMENT, 

IT TAKES NUMERIC ARGUMENTS OF ANY RANK, 



EXAMPLE • 


*0 => 


* 

1 * 1 = > 


2.713231823 




* * 5 = f 


1.64 3721 271 






* (3 ~ 2 ) 


=> 20.08553692 


.1353352332 
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POWER 



POWE 



♦ * ♦***♦•♦**♦♦♦**♦♦♦♦♦♦♦***♦♦*♦♦♦**♦♦* 

THE SYMBOL * (UPSHIFT P) IS USED FOR THE DYADIC POWER FUNCTION, 

THIS RETURNS THE VALUE (5) OF THE LEFT ARGUMENT RAISED TO THE POWER OF 
RIGHT ARGUMENT, ARGUMENTS ARE NUMERIC OF ANY RANK, 

A NON-INTEGER RIGHT ARGUMENT CAN BE USED TO OBTAIN ROOTS, 

FOR EXAMPLE* 2*3 => 3 3*0 => 1 4* *5 => 2 

TO RAISE EACH ELEMENT OF A VECTOR TO THE SAME POWER, ENTER V*P, 

TO RAISE A SCALAR TO A SERIES OF POWERS REPRESENTED BY A VECTOR, 

ENTER SftV, 

V 1 * V2 RESULTS IN THE ELEMENTS OF VI BEING RAISED TO THE POWER OF 
THE CORRESPONDING ELEMENT IN V2, 

VI AND V2 MUST HAVE THE SAME NUMBER OF ELEMENTS OR A 'LENGTH ERROR' 
WILL RESULT, 

FOR EXAMP-LE* 3* (123) =>39 27 (123) *3 => 18 27 

(2 3 4)*<5 4 3) => 32 81 64 

TO RAISE EACH ELEMENT OF THE MATRIX M TO THE SAME POWER 3, 

ENTER M*3, TO RAISE THE SCALAR S TO THE POWER OF EACH ELEMENT 
IN THE MATRIX M, ENTER S*M, 

THE RESULT WILL BE A MATRIX THE SAME SHAPE AS M, 

for example; if m => i 2 then 3*m =>39 and m*3 => 1 8 

3 4 27 81 27 64 

M 1 * M 2 RESULTS IN THE ELEMENTS OF Ml RAISE!' TO THE POWER 
OF THE CORRESPONDING ELEMENT IN M2. 



FOR EXAMPLE^ IF Mi => i 


2 AND M2 =) 4 


3 THEN M1*M2 


= > 1 


3 


3 


4 2 


1 


9 


4 



IF Mi AND M2 ARE MOT THE SAME SHAPE, A 'LENGTH ERROR' WILL OCCUR, 
IF ONE ARGUMENT IS A VECTOR WHILE THE OTHER ARGUMENT IS A MATRIX , 
THE RESULT WILL EE A 'RANK ERROR', 



THESE PRINCIPLES CAN EE EXTENDED TO HIGHER LEVEL ARRAYS, 
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NATURAL LO (5 



NATU 







THE SYMBOL a (ALT Q) IS USES FOP: THE MONADIC NATURAL LOG FUNCTION, 
IT RETURNS THE VALUE OF THE POWER TO WHICH THE CONSTANT E MUST 
BE RAISED TO EQUAL THE ARGUMENT, IN OTHER WORDS, ENTERING 
IS WILL SOLVE THE APL EQUATION *H = S FOR N, 

IT TAKES ONLY POSITIVE NUMERIC ARGUMENTS OF ANY RANK, USING a WITH 
ZERO OR WITH NEGATIVE ARGUMENTS WILL RESULT IN A 'DOMAIN ERROR', 
FOR EXAMPLE » 21 => Q *2.718281328 => 1 



91.643721271 



0.5 



for example; 9(3 2 ) 



1.093612289 0.6931471806 
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LOGARITHM 



L 06 A 



♦ ♦*♦♦♦♦»♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ a ♦♦♦♦♦♦♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ 
THE SYMBOL # (ALT 3) IS USED FOR THE DYADIC LOGARITHM FUNCTION, 

THIS RETURNS THE LOGARITHM OF THE RIGHT ARGUMENT IN THE BASE OF THE 
LEFT ARGUMENT, THAT IS, IT RETURNS THE VALUE OF THE POWER TO 
WHICH THE LEFT ARGUMENT MUST BE RAISED TO EQUAL THE RIGHT ARGUMENT, 
ENTER Lift TO SOLVE THE EQUATION L*N = R FOR N, 

ARGUMENTS ARE POSITIVE NUMERIC OF ANY RANK, USING 9 WITH ZERO OR WITH 
NEGATIVE NUMBERS WILL RESULT IN A 'DOMAIN ERROR', ENTERING 1*3 
WHERE S IS ANY NUMBER EXCEPT 1 WILL ALSO PRODUCE A 'DOMAIN ERROR', 

FOR EXAMPLE J lQ»iOO => 2 2*1024 => 10 9*1 = > 0 

TO OBTAIN THE LOG OF EACH ELEMENT OF A VECTOR IN THE SAME BASE, 

ENTER BaV , 

TO DETERMINE THE LOG OF A SCALAR IN A VECTOR OF DIFFERENT BASES, 

* 

ENTER VjS, 

Vi*V2 RESULTS IN THE LOG OF EACH ELEMENT IN V*2 IN THE BASE OF 
THE CORRESPONDING ELEMENT IN Vi, 

Vi AND V2 MUST HAVE THE SAME NUMBER OF ELEMENTS Oft A 'LENGTH ERROR' 
WILL RESULT, 

FOR example ; 3*(3 9 27 5 =>123 (2 45*16 =>42 

(2 3 553(4 9 255 => 222 

ANALOGOUS RESULTS ARE OBTAINED FOR MATRIXES AND HIGHER LEVEL ARRAYS, 
UNLES5S ONE ARGUMENT IS A SCALAR, BOTH ARGUMENTS MUST BE THE SAME 
SHAPE, OTHERWISE, A 'RANK ERROR' OR 'LENGTH ERROR' WILL RESULT, 
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PI TIMES 



PITI 



******************************* ® ********************************* 
THE SYMBOL 0 (UPSHIFT 0) IS USED FOR THE MONADIC PI TIMES FUNCTION* 

IT RETURNS THE VALUE OF THE CONSTANT PI TIMES THE ARGUMENT* 

IT TAKES NUMERIC ARGUMENTS OF ANY RANK * 



EXAMPLE * 


C i 

o 

ii 


t 

0 Ql = > 


3.141592654 




o.5 => 


1.570796327 






o(3 "2) 


=> 9 ,424777961 


"6.283185307 
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GEOMETRIC 



GEOM 



THE SYMBOL Q (UPSHIFT 0) IS USED FOR THE DYADIC GEOMETRIC FUNCTIONS , 
THESE INCLUDE THE MAIN TRIGI NOMETRIC FUNCTIONS # THE LEFT ARGUMENT , 
WHICH MUST BE AN INTEGER FROM “7 TO 7, DETERMINES WHICH FUNCTION 
IS CALLED, THE RIGHT ARGUMENT , WHICH CAN BE A NUMERIC ARRAY OF 
ANY RANK, REPRESENTS THE VALUE OF AN ANGLE IN RADIANS, 

THE FOLLOWING FUNCTIONS ARE REPRESENTED { 



o 

G 


~ > 


COS 


(ARCS IN Y) OR 


SIN 


(ARCCOS Y) WHERE |Y|<1 


1 0 Y 


= > 


S IN 


Y 


"10V 


=> ARCSIN Y WHERE |Y|<1 


20 Y 


= > 


COS 


Y 


"20V 


=> ARCCOS Y WHERE |Y|<1 


30 v 


— \ 


TAN 


Y 


-30V 


= > ARCTAN Y 


40 v 


= > 


COSH 


(ARCSINH Y) 


- 40 V 


= > SINH (ARCCOSH Y) WHERE 


50 V 


= > 


3INH 


Y 


"5ov 


=> ARCSINH Y 


60 V 


= > 


COSH 


T 


" 60 V 


= > ARCCOSH Y WHERE Y>1 


7 3 ' 


= > 


TANH 


Y 


- 70 V 


= > ARCTANH Y WHERE |Y|<J 


OTHER 


FUNCTIONS , 


SUCH AS SECANT, 


MUST BE COMPUTED BY FORMULA, 


FOR EX 


AMPLE 


♦ (REMEMBER Qj EQUAL 


S PI 


TIMES 1) 


loO 


— > 


0 


loal => 


0 


100,5 => 1 


2o0 


= > 


i 


2 ooi => 


” 1 


2oo,5 => 1.743934249E 



NOTICE THAT SOMETIMES A VERY SMALL NUMBER WILL APPEAR INSTEAD OF ZERO, 
OR A VERY LARGE NUMBER WILL APPEAR INSTEAD OF A DOMAIN ERROR, 
TECHNICALLY, THE TANGENT OF ONE -HALF PI DOES NOT EXIST, BUT \ 

300*5 => 5 ♦ 734161 139 E 1 5 watch cut for this; 
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FACTORIAL 



FACT 



THE SYMBOL { (ALT + ) IS USED FOP; THE MONADIC FACTORIAL FUNCTION, 

IT RETURNS THE FACTORIAL CF NON-NEGATIVE NUMERIC ARGUMENTS OF ANY RANK, 

for example: J1 3 0 => 1 6 1 

USING NON-INTEGER ARGUMENTS PRODUCES THE GAMMA FUNCTION CF THE 
ARGUMENT+1 * 

FOR example ♦ j 4 5 => *3862269255 (gamma of 1 , 5 ) 
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BINOMIAL 



BIMO 



♦ ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ ♦ ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ 
THE SYMBOL { (ALT +) IS USED FOR THE DYADIC BINOMIAL FUNCTION, 

IT TAKES NUMERIC ARGUMENTS OF ANY RANK, 

FOR POSITIVE INTEGER ARGUMENTS , LJR WILL RETURN THE NUMBER OF WAYS OF 
TAKING R OBJECTS' L AT A TIME, 

THIS IS THE BINOMIAL COEFFICIENT OF R OVER L , COMPUTED ( J R ) - J L X J ( F: - L ) , 
WITH NEGATIVE OR NON-INTEGER ARGUMENTS, THE BINOMIAL FUNCTION RETURNS 
A VALUE BASED ON THE BETA FUNCTION, 

FOR example; 3 ; 4 => 4 but 4 1 3 = > 0 

BECAUSE THERE ARE FOUR WAYS OF TAKING FOUR OBJECTS THREE AT A TIME, 
BUT THERE IS NO WAY TO TAKE THREE OBJECTS FOUR AT A TIME, 

THESE ANSWERS ARE BASED ON CONVENTION* 

O^O => 1 0 1 42 => 1 42 M2 => 1 

WHEN A SCALAR ARGUMENT IS PAIRED WITH A VECTOR ARGUMENT, THE FUNCTION 

COMBINES THE SCALAR WITH EACH ELEMENT OF THE VECTOR IN TURN, 

21(3 45) => 3610 (34 5)!5 = > 10 5 1 

CORRESPONDING ELEMENTS OF TWO VECTOR ARGUMENTS ARE COMBINED, 

(3 4 5)1(5 6 7) => 10 15 21 

VJ AND V2 MUST HAVE THE SAME NUMBER OF ELEMENTS OR A 'LENGTH ERROR* 
WILL RESULT, 

WHEN A SCALAR ARGUMENT IS PAIRED WITH A MATRIX ARGUMENT, THE FUNCTION 
COMBINES THE SCALAR WITH EACH ELEMENT OF THE MATRIX IN TURN, 

for example; if m => 12 then 3 ;m = > 0 0 M 13 =>3 3 

3 4 14 10 

CORRESPONDING ELEMENTS OF TWO MATRIX ARGUMENTS ARE COMBINED, 

FOR EXAMPLE* IF Ml => 1 2 M 2 => 3 4 THEN MJJM2 =>36 

34 56 10 15 

IF Ml AND M2 ARE NOT THE SAME SHAPE, A 'LENGTH ERROR* WILL OCCUR, 

IF ONE ARGUMENT IS A VECTOR WHILE THE OTHER ARGUMENT IS A MATRIX, 
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THE RE5ULT WILL SE A ‘RANK ERROR • 



THESE PRINCIPLES CAM BE EXTENDED TO HIGHER LEVEL 



f 



ARRAYS f 
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MAGNITUDE 



MAG N 



*♦****♦♦♦♦*♦♦**♦♦*♦**♦*♦*♦♦**♦* i 

THE SYMBOL | (UPSHIFT H) IS USED FOR THE MONADIC MAGNITUDE FUNCTION, 
IT RETURNS THE ABSOLUTE VALUE OF NUMERIC ARGUMENTS OF ANT RANK, 

FOR example: 10 => 0 I ("3 "2 10) => 3 2 10 
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SCAN 



5CA9 



\ ♦♦♦♦♦♦*♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦»»♦♦♦♦♦♦♦ 

THE SYMBOL \ (UPSHIFT /) IS USED FOLLOWING A DYADIC FUNCTION SYMBOL , 
PRECEDING A SINGLE ARGUMENT PRODUCING A MIXED FUNCTION CALLED SCAN , 

SCAN MAY BE USED WITH NUMERIC ARGUMENTS OF ANY RANK, 

SCAN MAY ALSO BE USED WITH CHARACTER ARGUMENTS IF THE FUNCTION IT IS 
COMBINED WITH ACCEPTS CHARACTER ARGUMENTS, 

USING \ WITH A SCALAR SIMPLY RETURNS THE SCALAR, 

WHEN USED WITH A VECTOR, SCAN GIVES THE SAME EFFECT AS INSERTING 
THE OTHER FUNCTION SYMBOL BETWEEN EACH VALUE OF THE VECTOR, 

THEN OPERATING PROGRESSIVELY AS FOLLOWS ♦ 

THE FIRST ELEMENT OF THE ANSWER WILL BE THE FIRST ELEMENT OF THE 
ARGUMENT, THE SECOND ELEMENT WILL BE THE RESULT OF THE MAIN 
FUNCTION OPERATING ON THE FIRST TWO ELEMENTS OF THE ARGUMENT, 

THE THIRD ELEMENT OF THE ANSWER WILL BE THE RESULT OF THE MAIN 
FUNCTION OPERATING AS IN REDUCTION ON THE FIRST THREE ELEMENTS 
OF THE ARGUMENT, AND SO ON, 

THE RESULT WILL ALWAYS BE THE SAME LENGTH AS THE ARGUMENT, 



EXAMPL 


E ; 








+\(1 2 


3) 


= > 1 


3 


6 BECAUSE 1 => 1, 1+2 => 3 J 1 + 2+3 => 6 


x\t2 3 


4) 


= > 2 


6 


24 



WHEN USING SCAN, ALWAYS REMEMBER APL READS RIGHT TO LEFT WHEN IT IS 
USING REDUCTION ON MORE THAN TWO ELEMENTS OF THE ARGUMENT, 

-\£1 23) => 1 *1 2 because i = > i, 1-2 => ~1, l-<2-3) => 2 

WHEN USED WITH A MATRIX, SCAN WILL PERFORM AS IF EACH COLUMN IS 
A UNIT, THE FIRST COLUMN OF THE ANSWER IS THE FIRST COLUMN OF 
THE ARGUMENT, THE SECOND COLUMN OF THE ANSWER IS THE RESULT OF 
OPERATING ON THE FIRST TWO COLUMNS OF THE ARGUMENT, AND 50 OH, 

APL USERS REFER TO THIS AS WORKING 1 ACROSS 1 OR 'OVER 1 THE COLUMNS, 
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SINCE COLUMNS ARE THE SECOND OF TWO DIMENSIONS OF A MATRIX, 

THIS MEANS THAT THE SYMBOL \ WORKS ‘OVER 1 THE LAST DIMENSION , 

TO SCAN OVER THE FIRST DIMENSION (E,G, ROWS OF A MATRIX), USE THE 
SYMBOL V (ALT , }, IN PLACE OF \, 

THIS IS IMPORTANT WHEN WORKING WITH H I G HER - D I MENS I ON AL ARRAYS, 

FDR EXAMPLE, IN A THREE-DIMENSIONAL ARRAY OF PAGES, ROWS, AND 
COLUMNS, \ WILL SCAN OVER THE COLUMNS, \ OVER THE PAGES , 

TO SCAN OVER ANY DIMENSION, YOU MAY SPECIFY THE DIMENSION IN 
BRACKETS FOLLOWING “ r HE \ (OR THE V) SYMBOL, 

FOR EXAMPLE, TO PLUS SCAN OVER THE ROWS OF A THREE-DIMENSIONAL 
ARRAY CALLED AA, ENTER *\[2] AA +\[21 AA * TO PLUS SCAN OVER 

THE PAGES, ENTER +\AA OR +\Q]AA, TO PLUS SCAN OVER THE COLUMNS, 
ENTER + \ A A OR +\[3]AA, 

THE RESULT WILL ALWAYS BE THE SAME SHAPE AS THE ARGUMENT, 
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SCAN 



SC A* 



THE SYMBOL V (ALT , ) IS USED FOLLOWING A DYADIC FUNCTION SYMBOL AND 

PRECEDING A SINGLE ARGUMENT PRODUCING A MIXED FUNCTION CALLED SCAN, 
SCAN MAY BE USED WITH NUMERIC ARGUMENTS OF ANY RANK, 

SCAN MAY ALSO BE USED WITH CHARACTER ARGUMENTS IF THE FUNCTION IT IS 
COMBINED WITH ACCEPTS CHARACTER ARGUMENTS, 

USING \ WITH A SCALAR SIMPLY RETURNS THE SCALAR, 

WHEN USED WITH A VECTOR, SCAN GIVES THE SAME EFFECT AS INSERTING 
THE OTHER FUNCTION SYMBOL BETWEEN EACH VALUE OF THE VECTOR, 

THEN OPERATING PROGRESSIVELY AS FOLLOWS: 

THE FIRST ELEMENT OF THE ANSWER WILL BE THE FIRST ELEMENT OF THE 
ARGUMENT, THE SECOND ELEMENT WILL BE THE RESULT OF THE MAIN 
FUNCTION OPERATING ON THE FIRST TWO ELEMENTS OF THE ARGUMENT, 

THE THIRD ELEMENT OF THE ANSWER WILL BE THE RESULT OF THE MAIN 
FUNCTION OPERATING AS IN REDUCTION ON THE FIRST THREE ELEMENTS 
OF THE AFGUMENT, AMD SO ON, 

THE RESULT WILL ALWAYS BE THE SAME LENGTH AS THE ARGUMENT, 

FOR EXAMPLE* 

+ \<1 23) => 136 because i => i, i+2 => 3> 1+2+3 => 6 

x\<2 34) => 2 6 24 

WHEN USING SCAN, ALWA'i S REMEMBER APL READS RIGHT TO LEFT WHEN IT IS 
USING REDUCTION ON MORE THAN TWO ELEMENTS OF THE ARGUMENT, 

-\(1 23 ) => 1 "1 2 because 1 => 1, 1-2 => “If l-(2-3) => 2 

WHEN USED WITH A MATRIX, SCAN WILL PERFORM AS IF EACH ROW IS 
A UNIT, THE FIRST ROW OF THE ANSWER IS THE FIRST ROW OF 

THE ARGUMENT, THE SECOND ROW OF THE ANSWER IS THE RESULT OF 

OPERATING ON THE FIRST TWO ROWS OF THE ARGUMENT, AND SO ON, 

APL USERS REFER TO THIS AS WORKING 1 ACROSS 1 OR 'OVER* THE ROWS, 
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SINCE ROWS ARE THE FIRST OF TWO DIMENSIONS OF A MATRIX, 

THIS MEANS THAT THE SYMBOL \ WORKS 'OVER 1 THE FIRST DIMENSION, 

TO SCAN OVER THE LAST DIMENSION (E,G, COLUMNS OF A MATRIX), USE 
THE SYMBOL \ (UPSHIFT /), IN PLACE OF 

THIS IS IMPORTANT WHEN WORKING WITH HIGHER-DIMENSIONAL ARRAYS , 

FOR EXAMPLE, IN A THREE-DIMENSIONAL ARRAY OF PAGES, ROWS, AND 
COLUMNS, \ WILL SCAN OVER THE COLUMNS, \ OVER THE PAGES , 

TO SCAN OVER ANY DIMENSION, YOU MAY SPECIFY THE DIMENSION IN 
BRACKETS FOLLOWING THE \ (OR THE \) SYMBOL , 

FOR EXAMPLE, TO PLUS SCAN OVER THE ROWS OF A THREE-DIMENSIONAL 
ARRAY CALLED AA, ENTER +\[23 AA 0F: +\C21 AA * T0 PLUS SCAN OVER 
THE PAGES, ENTER + \AA OR +\[1]AA, TO PLUS SCAN OVER THE COLUMNS, 
ENTER + \ A A OR +V[3]AA, 

THE RESULT WILL ALWAYS BE THE SAME SHAPE AS THE ARGUMENT, 
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CEILING 



CEIL 



***»*» + *»» + *»«*»»» + »»»♦*»♦*»»»« i ♦ ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦♦ 
THE SYMBOL f (UPSHIFT 5) IS USED FOR THE MONADIC CEILING FUNCTION f 
IT RETURNS THE VALUE OF NUMERIC ARGUMENTS OF ANY RANK, 1 ROUNDED UF « 

TO THE NEAREST INTEGER k 

FOR example; r< "3.4 0 1.3 2) => "3022 
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FLOOR 



FLOu 



♦ ♦♦♦♦♦♦♦*♦♦♦♦*♦♦*♦**♦*♦**♦♦♦♦♦♦ L ♦ ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦* 

THE SYMBOL L (UPSHIFT D ) IS USED FOR THE MONADIC FLOOR FUNCTION 
IT RETURNS THE VALUE OF NUMERIC ARGUMENTS OF ANY RANK, 1 ROUNDED 
TO THE NEAREST INTEGER, 

FOR example * L(”3.4 0 1*3 2) => “4012 



DOWN 1 
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MAXIMUM 



MAXI 
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*♦♦***»*«**♦♦♦«•*«•*♦**•**♦***♦ * **♦*♦****♦*«♦**♦*«******♦♦♦♦*•♦*♦♦ 
THE SYMBOL [ (UPSHIFT S) IS USED F OF: THE DYADIC MAXIMUM FUNCTION, 

THIS RETURNS THE MAXIMUM OF ITS TWO ARGUMENTS, WHICH ARE NUMERIC 
OF ANY RANK, 

FOR EXAMPLE*, 2T3 => 3 

TO CHECK A SCALAR AGAINST EACH ELEMENT OF A VECTOR, ENTER SfV OR VfS 
VifV2 WILL COMPARE TWO VECTORS ELEMENT BY ELEMENT, FOR EXAMPLE * 

4 F ( 3 4 5 ) = > 445 (3 4 5>T5 = > 555 

(3 4 5) T ( 1 5 9) = > 35? 

IF THE TWO VECTORS BEING COMPARED ARE NOT THE SAME LENGTH, 

A 'LENGTH ERROR' WILL RESULT, 

MATRIX COMPARISON IS DONE AS FOLLOWS; 

SfM OR Mf5 WILL CHECK THE SCALAR S AGAINST EACH ELEMENT OF 
THE MATRIX M, 

FOR example; if m => 12 then 3fM => 33 and mt3 =>33 

3 4 3 4 3 4 

M 1 T ^ 2 WILL COMPARE THE MATRIXES Ml AND M2, ELEMENT BY ELEMENT, 

for example; if mi => 1 2 and M 2 => 3 4 then m 1 f M 2 =>34 

3 4 5 6 5 6 

Ml AMD M2 MUST BE THE SAME SHAPE OR A 'LENGTH ERROR' WILL RESULT, 
TRYING TO COMPARE A VECTOR TO A MATRIX WILL RESULT IN A 'RANK ERROR' 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 
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MINIMUM 



MINI 



»*»*»»»»»*t*4»*»**t»**««» + »* + *» L ♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦**♦♦*♦♦♦♦♦♦♦♦♦♦♦♦*♦ 

THE SYMBOL L (UPSHIFT D) IS USED FOR THE DYADIC MINIMUM FUNCTION, 

THIS RETURNS THE MINIMUM OF ITS TWO ARGUMENTS f WHICH ARE NUMERIC 
OF ANY RANK, 



for example; 2 L 3 => 2 

TO CHECK A SCALAR AGAINST EACH ELEMENT OF A VECTOR, ENTER S[V OR V|_S, 
V 1 L V 2 WILL COMPARE TWO VECTORS ELEMENT BY ELEMENT, FOR EXAMPLE; 

4 L ( 3 4 5) => 3 4 4 (3 4 5)L5 => 3 4 5 

(3 4 5) L ( 1 59) => 145 

IF THE TWO VECTORS BEING COMPARED ARE NOT THE SAME LENGTH, 

6 'LENGTH ERROR' WILL RESULT, 

MATRIX COMPARISON IS DONE AS FOLLOWS; 

S|_M OR MLS WILL CHECK THE SCALAR S AGAINST EACH ELEMENT OF 
THE MATRIX M, 

for example; if m => i 2 then 3LM => 12 and W 13 =>12 

3 4 3 3 3 3 

M 1 L M 2 WILL COMPARE THE MATRIXES Ml AND M2 * ELEMENT BY ELEMENT, 

FOR example; IF Ml => 1 2 AND M2 => 3 4 THEN M 1 L M2 => 12 

3 4 5 6 3 4 

Ml AND M2 MUST BE THE SAME SHAPE OR A 'LENGTH ERROR' WILL RESULT, 
TRYING TO COMPARE A VECTOR TO A MATRIX WILL RESULT IN A 'RANK ERROR*, 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 
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RESIDUE 



RES I 



THE SYMBOL 1 (UPSHIFT M) IS USED FOR THE DYADIC RESIDUE FUNCTION. 

IT TAKES NUMERIC ARGUMENTS OF ANY RANK. 

THE RESULT OF L|R IS THE REMAINDER WHEN R IS DIVIDED BY L. THIS IS 
SIMILAR TO THE 1 MODULO 1 FUNCTION IN OTHER COMPUTER LANGUAGES. 



FOR EX AMPLE* 

111*24 => *24 101 "4 = > 2 ‘4110 => ‘2 

THE SIGN OF THE RESULT IS ALWAYS THE SAME AS THE SIGN OF THE LEFT 

ARGUMENT. IF THE SIGNS OF THE ARGUMENTS DO NOT AGREE, THE RESULT 
IS OBTAINED BY ADDING THE SMALLER ARGUMENT TO THE LARGER ONE 
REPEATEDLY UNTIL THE ABSOLUTE VALUE OF THE RESULT IS LESS THAN 
THE ABSOLUTE VALUE OF THE SMALLER ARGUMENT. 

WHEN A SCALAR ARGUMENT IS PAIRED WITH A VECTOR ARGUMENT, THE FUNCTION 
COMBINES THE SCALAR WITH EACH ELEMENT OF THE VECTOR IN TURN. 

21(1 2345) => 10101 (1234 5)13 => 01033 

CORRESPONDING ELEMENTS OF TWO VECTOR ARGUMENTS ARE COMBINED. 

( 11 * 52 ) 1 ( 123 ) => 00*51 

Vi AND V2 MUST HAVE THE SAME NUMBER OF ELEMENTS OR A 'LENGTH ERROR* 
WILL RESULT. 

WHEN A SCALAR ARGUMENT IS PAIRED WITH A MATRIX ARGUMENT, THE FUNCTION 
COMBINES THE SCALAR WITH EACH ELEMENT OF THE MATRIX IN TURN. 

for example; if m => i 2 then 3| m => 12 and m j 3 => 0 1 

3 4 0 1 0 3 

CORRESPONDING ELEMENTS OF TWO MATRIX ARGUMENTS ARE COMBINED. 

FOR example; IF Ml => 1 2 AND M 2 => 3 4 THEN *4 1 M 2 = > 2 2 

3 4 5 6 2 2 

IF Mi AND M2 ARE NOT THE SAME SHAPE, A 'LENGTH ERROR' WILL OCCUR. 

IF ONE ARGUMENT IS A VECTOR WHILE THE OTHER ARGUMENT IS A MATRIX, 
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THE 



THE RESULT WILL BE A ‘RANK ERROR 



SE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 



116 



166 



GRADE UP 



GRUP 



THE SYMBOL £ (ALT 4) IS USED FOR THE MOHADIC GRADE UP FUNCTION, 

IT TAKES A NUMERIC VECTOR ARGUMENT AND RETURNS A VECTOR OF THE 
INDEXES OF THE ELEMENTS IN ORDER FROM SMALLEST TO LARGEST , 

IN OTHER WORDS , THE FIRST ELEMENT IN THE RESPONSE IS THE INDEX 

OF THE SMALLEST ELEMENT IN THE INPUT, THE LAST ELEMENT IN THE 
RESPONSE IS THE INDEX OF THE LARGEST ELEMENT IN THE INPUT, 

EQUAL VALUES WILL BE GRADED IN ORDER FROM LEFT TO RIGHT, 

POR example: £4863 => 4132 

BECAUSE THE FOURTH ELEMENT OF THE INPUT (3) IS THE SMALLEST, ETC, 
THIS CAN BE USED TO SORT A VECTOR BY COMBINING WITH INDEX BRACKETS* 

IP V => 4 3 6 3 then V[*V] => 3463 

ON THE OTHER HAND, 4 >£V WILL PRODUCE A VECTOR OF THE POSITION NUMBERS 
(RANK ORDER) CORRESPONDING TO THE INPUT VECTOR, 

FOR EXAMPLE* ££4863 => 2431 

SINCE 4 IS THE SECOND SMALLEST ELEMENT, g IS THE FOURTH SMALLEST, ETC, 
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GRADS DOWN 



GRAD 



* * ♦ ♦ ♦ * 

THE SYMBOL f (ALT 3) IS USED FOR THE MONADIC GRADE DOWN FUNCTION , 

IT TAKES A NUMERIC VECTOR ARGUMENT AND RETURNS A VECTOR OF THE 
INDEXES OF THE ELEMENTS IN ORDER FROM LARGEST TO SMALLEST , 

IN OTHER WORDS, THE FIRST ELEMENT IN THE RESPONSE IS THE INDEX 
OF THE LARGEST ELEMENT IN THE INPUT, THE LAST ELEMENT IN THE 
RESPONSE IS THE INDEX OF THE SMALLEST ELEMENT IN THE INPUT, 

EQUAL VALUES WILL BE GRADED IN ORDER FROM LEFT TO RIGHT, 

FOR example: f 4 S i 3 = > 2314 

BECAUSE THE SECOND ELEMENT OF THE INPUT (Q) IS THE LARGEST, ETC, 
THIS CAN BE USED TO SORT A VECTOR BY COMBINING WITH INDEX BRACKETS J 

i p v =>4363 then v[*v] -> 3643 

ON THE OTHER HAND, ffV WILL PRODUCE A VECTOR OF THE POSITION NUMBERS 
(IN REVERSE ORDER) CORRESPONDING TO THE INPUT VECTOR, 

FOR example; n 4 3 4 3 => 3124 

SINCE 4 IS THE THIRD LARGEST ELEMENT, g IS THE LARGEST, ETC, 
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ROLL 



ROLL 



THE SYMBOL ? (UPSHIFT G ) IS USED FOP: THE MONADIC ROLL FUNCTION, 
THIS IS A RANDOM NUMBER GENERATOR WHICH TAKES POSITIVE INTEGER 
ARGUMENTS AND RETURNS A RANDOMLY SELECTED INTEGER UP TO THE 
VALUE OF THE ARGUMENT, 

THE LOWEST POSSIBLE VALUE WHICH CAN BE RETURNED IS NORMALLY (BY 
DEFAULT) 1, 

USING ? WITH NEGATIVE ARGUMENTS OR ZERO PRODUCES A ’ DOMAIN ERROR*, 
FOR EXAMPLE* ?3 => EITHER 1, 2 } OR 3f WITH EQUAL PROBABILITY 



WHEN USED WITH VECTORS, ROLL RETURNS A VECTOR WITH EACH NUMBER 

SELECTED RANDOMLY FROM THE RANGE DETERMININED BY THE CORRESPONDING 
VALUE IN THE ARGUMENT t 
FOR EXAMPLE* 

?3 3 3 => 112 or 132 or 332 or 213 etc, 

?£ £ SIMULATES the ROLLING OF A PAIR OF DICE, 

ROLL CAN BE USED WITH MATRIXES OR HIGHER LEVEL ARRAYS IN A SIMILAR 
FASHION , 
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DEAL 



DEAL 



THE SYMBOL ? (UPSHIFT G) IS USED F OF: THE DYADIC DEAL FUNCTION, 

THE RESULT OF THIS FUNCTION IS AN ARRAY OF RANDOM NUMBERS, 

THE SHAPE OF THE ARRAY IS DETERMINED BY THE LEFT ARGUMENT, 

THE NUMBERS ARE RANDOMLY SELECTED FROM THE POSITIVE INTEGERS 
UP TO THE VALUE OF THE RIGHT ARGUMENT 1 WITH HO REPLACEMENT, 
THAT IS, A NUMBER CANNOT APPEAR TWICE IN THE RESULT, 

BOTH ARGUMENTS MUST BE A POSITIVE SINGLE NUMBER (SCALAR OF: VECTOR 
OF LENGTH J), AND THE RIGHT MUST EQUAL OR EXCEED THE LEFT, 
USING HIGHER-ORDER ARGUMENTS PRODUCES A 'RANK ERROR*, 

USING NEGATIVE ARGUMENTS OR ZERO PRODUCES A 'DOMAIN ERROR*, 

FOR EXAMPLE ♦ 2?2 => 12 0R 21 BUT N0T 2 2 1 1 

5?52 SIMULATES THE DEAL OF A HAND OF CARDS, 
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EQUAL 



E QU A 



THE SYMBOL = (UPSHIFT 5) IS USED F OF: THE DYADIC EQUALS FUNCTION* 

THIS COMPARES NUMERIC OR CHARACTER ARGUMENTS OF ANY RANK* 

IT RETURNS 1 FOR EACH ELEMENT OF THE LEFT ARGUMENT THAT IS IDENTICAL 
TO THE CORRESPONDING ELEMENT OF THE RIGHT ARGUMENT , AND Q FOR 
EACH ELEMENT THAT IS NOT* 

FOR EXAMPLE* 2=2 => 1 2=4 => 0 ' A‘=*B« => 0 

TO COMPARE A SCALAR TO EACH ELEMENT OF A VECTOR. f 
ENTER EITHER S = V OR V=S* 

2= (2 2 4 ) => 1 0 0 (34 5)=5 => 001 

V 1 ~ V 2 WILL COMPARE TWO VECTORS ELEMENT BY ELEMENT* FOR EXAMPLE** 

* THINK ' = ' THANK 1 => 1 1 0 1 1 

IF THE TWO VECTORS BEING COMPARED ARE NOT THE SAME LENGTH, 

YOU WILL GET A 'LENGTH ERROR'* 

MATRIX COMPARISON IS DONE AS FOLLOWS* 

5=M OR M=5 WILL COMPARE THE SCALAR 5 TO EACH ELEMENT OF THE MATRIX M* 
FOR EXAMPLE* IF M => 12 THEN 3=M => Q 0 AND M = 3 =>00 

3 4 10 10 

M 1 =M2 WILL COMPARE THE MATRIX Ml TO THE MATRIX H2t ELEMENT BY ELEMENT* 
FOR EXAMPLE* IF Ml => HOW AND M2 => OOH THEN M1 = M2 => 010 

NOW WOW Oil 

Ml AND M2 MUST BE THE SAME SHAPE OR A 'LENGTH ERROR' WILL RESULT* 
COMPARING A VECTOR TO A MATRIX WILL RESULT IN A 'RANK ERROR'* 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS* 
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HOT EQUAL 



MOTE 



♦ ♦♦♦♦♦*♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦ r ♦ ♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦•*♦*♦♦♦♦♦ 

THE SYMBOL ^ (UPSHIFT g) IS USED FOR THE DYADIC MOT EQUAL FUNCTION, 
THIS COMPARES NUMERIC OP CHARACTER ARGUMENTS OF ANY RANK, 

IT RETURNS 1 FOR EACH ELEMENT OF THE LEFT ARGUMENT THAT IS NOT EQUAL 
TO THE CORRESPONDING ELEMENT OF THE RIGHT ARGUMENT , AND Q FOR 
EACH ELEMENT THAT IS, 

for example; 2*2 = > 0 2^4 => 1 'A'jf'B* = > i 

TO COMPARE A SCALAR TO EACH ELEMENT OF A VECTOR, 

ENTER EITHER 5?fV OR VjfS , 

2^(2 3 4) => 0 1 1 (34 5)^5 => 110 

Vi ,*V2 WILL COMPARE TWO VECTORS ELEMENT BY ELEMENT, FOR EXAMPLE* 

■ THINK 1 j* 1 THANK 1 => 0 0 10 0 

IF THE TWO VECTORS BEING COMPARED ARE MGT THE SAME LENGTH, 

YOU WILL GET A 'LENGTH ERROR', 

MATRIX COMPARISON IS DONE AS FOLLOWS J 

Spf M OR MpfS WILL COMPARE THE SCALAR S TO EACH ELEMENT OF THE MATRIX M , 
FOR EXAMPLE ♦ I F M - > J J THEN 3^M = > 11 AND M ^ 3 =>11 

3 4 0 1 0 1 

MljxfM2 WILL COMPARE THE MATRIX Ml TO THE MATRIX M2, ELEMENT BY ELEMENT, 
FOR EXAMPLE* IF Ml => HOW AND M2 => OOH THEN Ml ? fM2 => 10 1 

NOW WOW 100 

Ml AND M2 MUST BE THE SAME SHAPE OR A 'LENGTH ERROR' WILL RESULT, 
COMPARING A VECTOR TO A MATRIX WILL RESULT IN A 'RANK ERROR', 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 
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LESS THAI! 



LESS 



♦ ♦♦♦*♦♦♦*♦♦♦*♦»♦♦♦♦♦*♦•***♦»**♦ < »*♦*♦♦♦*♦♦*♦*♦*♦♦♦ m ♦*»♦»*♦*»♦»»*» » 

THE SYMBOL < (UPSHIFT 3) IS USED FOR THE DYADIC LESS THAN FUNCTION, 
THIS COMPARES NUMERIC ARGUMENTS OF ANY RANK, 

IT RETURNS 1 FOR EACH ELEMENT OF THE LEFT ARGUMENT THAT IS LESS 

THAN THE CORRESPONDING ELEMENT OF THE RIGHT ARGUMENT, AND 0 FOR 
EACH ELEMENT THAT IS NOT, 

for example; 2<2 => 0 2<4 => 1 

TO COMPARE A SCALAR TO EACH ELEMENT OF A VECTOR, 

ENTER EITHER S<V OR V<5, ORDER IS IMPORTANT, 

2 <(123) => 001 (345X5 => 110 

Vi<V2 WILL COMPARE TWO VECTORS ELEMENT BY ELEMENT, FOR EXAMPLE* 

(1 2 3) < ( 1 35) => Oil 

IF THE TWO VECTORS BEING COMPARED ARE NOT THE SAME LENGTH , 

YOU WILL GET A ‘LENGTH ERROR', 

MATRIX COMPARISON IS DONE AS FOLLOWS; 

S < M OR M'S WILL COMPARE THE SCALAR 5 TO EACH ELEMENT OF THE MATRIX M, 

for example; if m => 12 then 3 <m => q q and m <3 => i l 

3 4 0 1 0 0 

M 1 < M 2 WILL COMPARE THE MATRIX Ml TO THE MATRIX M2, ELEMENT BY ELEMENT, 
FOR EXAMPLE; IF Ml => 1 4 AND M2 => 2 6 THEN M1<M2 => 11 

4 7 5 3 1 0 

Ml AND M2 MUST BE THE SAME SHAPE OR A ‘LENGTH ERROR 1 WILL RESULT, 
COMPARING A VECTOR TO A MATRIX WILL RESULT IN A ‘RANK ERROR 1 , 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 



133 



LESS OR EQUAL 



LTEG 



♦ *♦♦*♦***♦♦♦♦♦*♦♦♦♦**♦**♦**♦*♦* — ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ 
THE SYMBOL 2 (UPSHIFT 4) IS USED FOR THE DYADIC LESS THAN OR EQUAL TO 

FUNCTION, THIS COMPARES NUMERIC ARGUMENTS OF AMY RANK, 

IT RETURNS 1 FOR EACH ELEMENT OF THE LEFT ARGUMENT THAT IS LESS THAN 
OR EQUAL TO THE CORRESPONDING ELEMENT OF THE RIGHT ARGUMENT, AND 
o FOR EACH ELEMENT THAT IS NOT, 

for example; 212 => 1 214 => 1 21"2 => 0 

TO COMPARE A SCALAR TO EACH ELEMENT OF A VECTOR, 

ENTER EITHER S <_V OR V < S , ORDER IS IMPORTANT, 

21(1 2 3 ) => 0 1 1 (34 5)15 => 111 

VHV2 WILL COMPARE TWO VECTORS ELEMENT BY ELEMENT, FOR EXAMPLE; 

(1 2 3 ) 1(1 35 ) => 111 

IF THE TWO VECTORS BEING COMPARED ARE NOT THE SAKE LENGTH, 

YOU WILL GET A ‘LENGTH ERROR*, 

MATRIX COMPARISON IS DONE AS FOLLOWS; 

S 2 M OR bus WILL COMPARE THE SCALAR S TO EACH ELEMENT OF THE MATRIX M, 
FOR EXAMPLE; IP M => 12 THEN 31M = > 0 0 AMD MJ_3 =>11 

3 4 11 10 

M12M2 WILL COMPARE THE MATRIX Ml TO THE MATRIX M2, ELEMENT BY ELEMENT, 
FOR EXAMPLE; IF Ml => 14 AND ^2 => 2 6 THEN M1£M2 => ll 

4 7 5 3 1 0 

M 1 AND M2 MUST BE THE SAME SHAPE OR A ‘LENGTH ERROR ‘ WILL RESULT, 
COMPARING A VECTOR TO A MATRIX WILL RESULT IN A ‘RANK ERROR', 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 
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GREATER OR EQUAL 



GTEQ 



THE SYMBOL )_ (UPSHIFT £) IS USED FOR THE DYADIC GREATER THAN OR EQUAL 
TO FUNCTION , THIS COMPARES NUMERIC ARGUMENTS OF ANY RANK, 

IT RETURNS 1 FOR EACH ELEMENT OF THE LEFT ARGUMENT THAT IS GREATER 
THAN OR EQUAL TO THE CORRESPONDING ELEMENT OF THE RIGHT ARGUMENT, 
AND 0 F0P: EACH ELEMENT THAT IS NOT, 

for example; 212 = > 1 214 = > 0 21~2 = > 1 

TO COMPARE a SCALAR TO EACH ELEMENT OF A VECTOR, 

ENTER EITHER 5VV OR V>_S, ORDER IS IMPORTANT, 

21(1 2 3) => 110 (3 4 5)15 => 001 

v ll v 2 WILL COMPARE TWO VECTORS ELEMENT BY ELEMENT, FOR EXAMPLE* 

(1 2 3)1(1 35) => 100 

IF THE TWO VECTORS BEING COMPARED ARE NOT THE SAME LENGTH, 

YOU WILL GET A > LENGTH ERROR', 

MATRIX COMPARISON IS DONE AS FOLLOWS; 

3>,M OR M2.S WILL COMPARE THE SCALAR S TO EACH ELEMENT OF THE MATRIX M, 

for example; if m => i 2 then 3 >.m - > i i and m ^3 = > q 0 

3 4 10 11 

M1VM2 WILL COMPARE THE MATRIX Ml TO THE MATRIX M2, ELEMENT BY ELEMENT, 
FOR EXAMPLE* IF Ml => 1 4 AND M2 =>2 6 THEN M12.M2 => 0 0 

4 7 5 3 0 1 

Ml AND M2 MUST BE THE SAME SHAPE OR A 'LENGTH ERROR' WILL RESULT, 
COMPARING A VECTOR TO A MATRIX WILL RESULT IN A 'RANK ERROR', 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 
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GREATER THAN 



GRZ A 



1S5 



THE SYMBOL > (UPSHIFT 7) IS USED *OR THE DYADIC GREATER THAN 
FUNCTION, THIS COMPARES NUMERIC ARGUMENTS OF ANY RANK, 

IT RETURNS 1 FOR EACH ELEMENT OF THE LEFT ARGUMENT THAT IS GREATER 
THAN THE CORRESPONDING ELEMENT OF THE RIGHT ARGUMENT , AND Q FOR 
EACH ELEMENT THAT IS NOT, 

fop example; 2> 2 => 0 4>2 => 1 

TO COMPARE A SCALAR TO EACH ELEMENT OF A VECTOR, 

ENTER EITHER 5>V OR V>5, ORDER IS IMPORTANT, 

2X1 2 3) => 1 0 0 (3 4 5 ) > 5 = > 0 0 0 

V1>V2 WILL. COMPARE TWO VECTORS ELEMENT BY ELEMENT, FOR EXAMPLE; 

(1 2 3 ) > ( 1 35 ) = > 000 

IF THE TWO VECTORS BEING COMPARED ARE HOT THE SAME LENGTH, 

YOU WILL GET A 1 LENGTH ERROR', 

MATRIX COMPARISON IS DONE AS FOLLOWS; 

5 > M OR M > S WILL COMPARE THE SCALAR S TO EACH ELEMENT OF THE MATRIX M, 

FOR EXAMPLE; IF H :> 1 J THEN 3>M => 11 AND M>3 =>00 

3 4 0 0 0 1 

M 1 > M 2 WILL COMPARE THE MATRIX Ml TO THE MATRIX M2* ELEMENT BY ELEMENT, 

FOR EXAMPLE 4 , IF Ml => 1 4 AND M2 => 2 6 THEN Mi>M2 => 0 0 

4 7 13 11 

Ml AND M2 MUST BE THE SAME SHAPE OR A 'LENGTH ERROR' WILL RESULT, 
COMPARING A VECTOR TO A MATRIX WILL RESULT IN A 'RANK ERROR 1 , 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 
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NOT 



HOT 



******************************* ” ********************************** 
THE SYMBOL .v (UPSHIFT T) IS USED FOR THE MONADIC HOT FUNCTION, 

IT TAKES AN ARGUMENT OF ANY RANK WHICH CONSISTS ONLY OF 1 >5 AND Q ' S , 
AND RETURNS THE LOGICAL INVERSE, THAT IS, i»S ARE CHANGED TO Q‘S 
AND A‘ s AP:E CHANGED TO I'S, 

FOR example; *1 0 0 1 => 0110 
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AND 



AND 



******************************* A *********************************** 
THE SYMBOL A (UPSHIFT Q ) IS USED FOR THE DYADIC AMD FUNCTION, 

IT TAKES ARGUMENTS OF ANY RANK WHICH CONSIST ONLY OF 1 1 S AND Q' s , 
THIS FUNCTION RETURNS j[ WHERE BOTH ARGUMENTS ARE 1, AND Q OTHERWISE, 
THE ORDER OF THE ARGUMENTS IS NOT IMPORTANT , BUT ENTERING AN ARGUMENT 
WHICH IS NOT 1 OR 0 WILL PRODUCE A 'DOMAIN ERROR', 

FOR EXAMPLE* J.A1 = > 1 IaQ => 0 0*0 => 0 

TO COMPARE A SCALAR TO EACH ELEMENT OF AN ARRAY, 

ENTER EITHER SaA OR AaS, FOR EXAMPLE, IF V => 2 “3 0 

IMxv) = > 10 0 (v=2> a v[ 1 3=2 => 10 0 

A1aA2 WILL COMPARE TWO ARRAYS ELEMENT BY ELEMENT, FOR EXAMPLE* 

(V>-3) A ( V < 2 ) => 0 0 1 



IP Ml => 1 AND 


M2 => l 


l 


THEM M1AM2 => 1 


0 


1 0 


0 


0 


0 


0 



A 1 AND A 2 MUST BE THE SAME SHAPE OR A 'LENGTH ERROR' WILL RESULT, 
COMPARING TWO ARRAYS OF DIFFERENT RANK, FOR EXAMPLE A VECTOR AND A 
MATRIX, WILL RESULT IN A 'RANK ERROR’, 
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HAND 



HAND 



♦ ♦♦♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦*♦ * ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ 
THE SYMBOL * (ALT 0) 1S USED FOR THE DYADIC HOT AMD FUNCTION. 

IT TAKES ARGUMENTS OF AMY RANK WHICH CONSIST ONLY OF \ ' 5 AMD Q'S, 
THIS FUNCTION RETURNS 1 WHERE ONE OR NEITHER OF THE ARGUMENTS ARE 1, 
AMD 0 OTHERWISE (WHERE BOTH ARE 1), 

THE ORDER OF THE ARGUMENTS IS NOT IMPORTANT, BUT ENTERING AM ARGUMENT 
WHICH IS NOT 1 OR Q WILL PRODUCE A 'DOMAIN ERROR' f 

FOR EXAMPLE ♦ 1*1 => Q 1*0 => 1 0*G => 1 

TO COMPARE A SCALAR TO EACH ELEMENT OF AN ARRAY, 

ENTER EITHER S*A OR A*S, FOR EXAMPLE, IF V => 2 ”3 0 



1*<XV) 


II 

o 


1 1 


<v= 2 > * 


vci:=2 => 


0 1 


1 


will 


COMPARE 


TWO 


ARRAYS ELEMENT 


BY ELEMENT, 


FOR 


EXAMPLE J 


<v>“3) 


( v < 2 ) 


— \ 


1 1 0 








IF Ml => 1 


0 ft HD 


M2 


=>11 THEN 


M1aM2 => 0 


i 




1 


0 




0 0 


1 


1 





A 1 AND A2 MUST BE THE SAME SHAPE OR A 'LENGTH ERROR' WILL RESULT f 
COMPARING TWO ARRAYS OF DIFFERENT RANK, FOR EXAMPLE A VECTOR AND A 
MATRIX, WILL RESULT IN A 'RANK ERROR' t 
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OR 



OR 



THE SYMBOL v (UPSHIFT 9) IS USED FOR THE DYADIC OR FUNCTION, 

IT TAKES ARGUMENTS OF ANY RANK WHICH CONSIST ONLY OF i‘S AND Q * S , 
THIS FUNCTION RETURNS 1 WHERE ONE OR BOTH ARGUMENTS ARE 1, 

AND 0 OTHERWISE (WHERE BOTH ARE Q) ♦ 

THE ORDER OF THE ARGUMENTS IS NOT IMPORTANT, BUT ENTERING AN ARGUMENT 
WHICH IS NOT 1 OR Q WILL PRODUCE A * DOMAIN ERROR 1 , 

FOR EXAMPLE • Ivl => 1 lvO => 1 OvQ => 0 

TO COMPARE A SCALAR TO EACH ELEMENT OF AN ARRAY, 

ENTER EITHER S V A OP: AvS, FOR EXAMPLE, IF V = > 2 ”3 0 

lv(xv) => 1 l i (v=2) v v[ i ]=3 => 100 

Alv*2 WILL COMPARE TWO ARRAYS ELEMENT BY ELEMENT, FOR EXAMPLE J 

(V>~3) v (V<2) => 111 

IF Ml => 1 0 AND M2 => 1 1 THEN MlvM2 => 11 

1 0 0 0 1 0 

A 1 AND A2 MUST BE THE 5 AME SHARE OR A 'LENGTH ERROR' WILL RESULT, 
COMPARING TWO ARRAYS OF DIFFERENT RANK, FOR EXAMPLE A VECTOR AND A 
MATRIX, WILL RESULT IN A 'RANK ERROR', 
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HOF: 



HOF: 



THE SYMBOL * (ALT 9) IS USED FOR THE DYADIC HOR FUMCTIOM, 

IT TAKES ARGUMENTS OF ANY RANK WHICH CONSIST ONLY OF l‘S AND Q ' s ♦ 
THIS FUNCTION RETURNS 1 WHERE NEITHER OF THE ARGUMENTS ARE 1, 

AND 0 OTHERWISE, 

THE ORDER OF THE ARGUMENTS IS NOT IMPORTANT, BUT ENTERING AN ARGUMENT 
WHICH IS NOT i OR Q WILL PRODUCE A ‘DOMAIN ERROR', 

FOR EXAMPLE * 1*1 => Q 1*0 => 0 0*0 => 1 

TO COMPARE A SCALAR TO EACH ELEMENT OF AN ARRAY, 

ENTER EITHER S*A OR AyS, FOR EXAMPLE, IF V => 2 “3 0 



1 v ( X v ) 


= > 0 


0 0 


( 


v= 2 ) * 


VC 13=3 => 


0 1 1 


ftlvA2 WILL 


COMPARE 


TWO 


ARRAYS 


ELEMENT 


BY ELEMENT, 


FOR EXAMPLE* 


<v>"3) 1 


< v < 2 ) 


= > 


0 0 0 








IF Ml => 1 


0 AMD 


M2 


= > 1 1 


THEN 


MlvM2 => 0 


0 


1 


0 




0 0 




0 


1 



A 1 AND A2 MUST BE THE SAME SHAPE OR A 'LENGTH ERROR 1 WILL RESULT, 
COMPARING TWO ARRAYS OF DIFFERENT RANK, FOR EXAMPLE A VECTOR AND A 
MATRIX, WILL RESULT IN A 'RANK ERROR 1 , 
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MEMBER OF 



MEM B 



THE SYMBOL g (UPSHIFT E ) IS USED FOR THE DYADIC MEMBER OF FUNCTION, 
THIS COMPARES NUMERIC OR CHARACTER ARGUMENTS OF ANY RANK, 

IT RETURNS 1 FOR EACH ELEMENT OF THE LEFT ARGUMENT THAT IS FOUND 
ANYWHERE IN THE RIGHT ARGUMENT } AND 0 F0R EVERY ELEMENT 
THAT IS NOT, 

WITH TWO SCALAR ARGUMENTS f g IS EQUIVALENT TO = , 

FOR example; 2s 2 => 1 2s4 => 0 'a» € 'B» => o 



2 £ ( 2 3 4) => 1 1 A’-c ’ABC' = > 1 

ENTERING AgS WILL PRODUCE THE SAME RESULT AS A=S , 



A ^ g A2 WILL TAKE EACH ELEMENT OF THE LEFT ARRAY AMD DETERMINE IF 
IT IS CONTAINED IN THE RIGHT ARRAY, 

for example; • which 1 1 e '0123456739 s => 0000001 

IF A1 = > 1 22 14 and A2 =r> 12 3 

33 5 2 

then AigA2 => 10 0 and a 2 g a i = > 110 

0 0 1 

THE RESULT OF Aj.gA2 HAS THE SAME SHAPE AS AJ., 
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REVERSE 



REVO 



♦ *♦♦*♦♦•**♦♦♦♦♦*♦♦♦**♦♦*♦**♦♦** $ ♦♦♦♦♦♦*♦♦»♦♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ 
THE SYMBOL $ (ALT 5) IS USED FOR THE MONADIC REVERSE FUNCTION, 

IT TAKES NUMERIC OR CHARACTER ARGUMENTS OF ANY RANK, 

IT RETURNS ALL THE ELEMENTS OF THE ARGUMENT IN THE SAME SHAPE, 

BUT IN A DIFFERENT ORDER, AS FOLLOWS, 

USING $ WITH A SCALAR SIMPLY RETURNS THE SCALAR, 

USING $ WITH A VECTOR RETURNS THE VECTOR IN REVERSE ORDER, 

FOR example: 12 3 5 => 532 

(J) 1 STOP 1 => POTS 

WHEN USED WITH A MATRIX, Q TAKES THE COLUMNS AS UNITS AND REVERSES 
THEM, THE FIRST COLUMN BECOMES THE LAST COLUMN, AND SO ON, 

FOR EXAMPLE, IF M => 123 THEN => 321 

4 5 6 6 5 4 

7 3 9 9 3 7 

APL USERS REFER TO THIS AS WORKING 'ACROSS 1 OR 'OVER' THE COLUMNS, 
SINCE COLUMNS ARE THE SECOND OF TWO DIMENSIONS OF A MATRIX, 

THIS MEANS THAT THE SYMBOL $ WORKS 'OVER' THE LAST DIMENSION, 

TO REVERSE OVER THE FIRST DIMENSION ( E , G , ROWS OF A MATRIX), USE THE 
SYMBOL 0 (ALT 7), IN PLACE OF $ , 

THIS IS IMPORTANT WHEN WORKING WITH HIGHER-DIMENSIONAL ARRAYS, 

FOR EXAMPLE, IN A THREE-DIMENSIONAL ARRAY OF PAGES, ROWS, AND 
COLUMNS, $ WILL REVERSE OVER THE COLUMNS, 9 OVER THE PAGES, 

TO REVERSE OVER ANY DIMENSION, YOU MAY SPECIFY THE DIMENSION IN 
BRACKETS FOLLOWING THE $ (OR THE 0) SYMBOL, 

FOR EXAMPLE, TO REVERSE OVER THE ROWS OF A THREE-DIMENSIONAL ARRAY 
CALLED AA, ENTER 0C2] AA 0R 0[23 AA * T0 REVERSE OVER THE PAGES, 
ENTER 0 A A OR $[1]AA, TO REVERSE OVER THE COLUMNS, ENTER $AA 

or e[33 AA . 
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REVERSE 



REVi 



THE SYMBOL 0 (ALT 7) IS USED FOR THE MONADIC REVERSE FUNCTION, 
IT TAKES NUMERIC OR CHARACTER ARGUMENTS OF ANY RANK, 

IT RETURNS ALL THE ELEMENTS OF THE ARGUMENT IN THE SAME SHAPE , 
BUT IN A DIFFERENT ORDER , AS FOLLOWS, 



USING 9 WITH A SCALAR SIMPLY RETURNS THE SCALAR, 

USING 8 WITH A VECTOR RETURNS THE VECTOR IN REVERSE ORDER, 

FOR EXAMPLE ; «2 3 5 => 532 

q'STOP' => POTS 

WHEN USED WITH A MATRIX, 0 TAKES THE ROWS AS UNITS AND .REVERSES 
THEM, THE FIRST ROW BECOMES THE LAST ROW, AND SO ON, 

FOR EXAMPLE, I F M = > 123 THEN qM => 789 

4 5 6 4 5 6 

7 8 9 1 2 3 

APL USERS REFER TO THIS AS WORKING 'ACROSS' OR 'OVER 1 THE ROWS, 
SINCE ROWS ARE THE FIRST OF TWO DIMENSIONS OF A MATRIX, 

THIS MEANS THAT THE SYMBOL g WORKS 'OVER' THE FIRST DIMENSION, 
TO REVERSE OVER THE LAST DIMENSION ( E , G , COLUMNS OF A MATRIX), 

USE THE SYMBOL 0 (ALT 5), IN FLACE OF g, 

THIS IS IMPORTANT WHEN WORKING WITH H I GHER -D I MENS I ON AL ARRAYS, 

FOR EXAMPLE, IN A THREE-DIMENSIONAL ARRAY OF PAGES, ROWS, AND 
COLUMNS, WILL REVERSE OVER THE COLUMNS, g OVER THE PAGES, 

TO REVERSE OVER ANY DIMENSION, YOU MAY SPECIFY THE DIMENSION IN 
BRACKETS FOLLOWING THE a (OR THE (Js ) SYMBOL, 

FOR EXAMPLE, TO REVERSE OVER THE ROWS OF A THREE-DIMENSIONAL ARRAY 
CALLED AA, ENTER a[2j Aa OR ®C23 ftA . T0 REVERSE OVER THE RAGES, 
ENTER gA A OR 1 JQ 3 AA, T0 REVERSE OVER THE COLUMNS, ENTER 0 AA 
OR eC3]AA. 
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ROTATE 



ROTO 



♦ $ ♦♦♦*♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦*♦♦♦*♦♦ 
THE SYMBOL $ (ALT 5) IS USED FOR THE DYADIC ROTATE FUNCTION, 

THE RIGHT ARGUMENT CAN BE CHARACTER OR NUMERIC, OF ANY RANK, 

THE LEFT ARGUMENT MUST BE AN INTEGER SCALAR OR ARRAY, 

IT RETURNS ALL THE ELEMENTS OF THE RIGHT ARGUMENT IN THE SAME SHARE, 
BUT IN A DIFFERENT ORDER, AS FOLLOWS, 

USING $ WITH TWO SCALAR ARGUMENTS SIMPLY RETURNS THE RIGHT ARGUMENT, 

A VECTOR RIGHT ARGUMENT REQUIRES A SCALAR LEFT ARGUMENT, 

EACH ELEMENT OF THE RIGHT ARGUMENT IS MOVED TO THE LEFT BY THE NUMBER 
OF PLACES INDICATED IN THE LEFT ARGUMENT, 

for example; 202 3 5 => 5 2 3 30 1 rotate 1 = > aterot 

WHEN USED WITH A MATRIX, $ TAKES EITHER A SCALAR LEFT ARGUMENT OR A 
VECTOR WITH AS MANY ELEMENTS AS THERE ARE ROWS IN THE MATRIX, 

Sf{)M TAKES THE COLUMNS AS UNITS AND MOVES EACH COLUMN TO THE LEFT BY 
THE NUMBER OF SPACES INDICATED BY THE SCALAR, 

for example; if m => 123 then => 312 

4 5 6 6 4 5 

7 3 9 9 7 8 

V$M TAKES EACH ROW INDIVIDUALLY AND MOVES THE ELEMENTS TO THE LEFT BY 
THE NUMBER OF SPACES INDICATED BY THE CORRESPONDING ELEMENT OF THE 
LEFT ARGUMENT, FOR EXAMPLE; 

2 3 1$ M => 312 THE FIRST ROW IS MOVED 2 SPACES LEFT 

4 5 6 THE SECOND ROW IS ROTATED 3 SPACES 

397 THE THIRD ROW IS ROTATED ONCE 

EACH ELEMENT IS IN THE SAME ROW BUT A DIFFERENT COLUMN, SO APL 

USERS REFER TO THIS AS WORKING ‘ACROSS 1 OR ‘OVER 1 THE COLUMNS, 
SINCE COLUMNS ARE THE SECOND OF TWO DIMENSIONS OF A MATRIX, 

THIS MEANS THAT THE SYMBOL $ WORKS 1 OVER 1 THE LAST DIMENSION, 

TO ROTATE OVER THE FIRST DIMENSION ( E , G , ROWS OF A MATRIX), USE THE 
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SYMBOL e (ALT 7), IN PLACE OF $ 



THIS IS IMPORTANT WHEN WORKING WITH HIGHER-DIMENSIONAL ARRAYS, 

FOR EXAMPLE, IN A THREE-DIMENSIONAL ARRAY OF PAGES, ROWS, AND 
COLUMNS, $ WILL ROTATE OVER THE COLUMNS, 8 OVER THE PAGES , 

TO ROTATE OVER ANY DIMENSION, YOU MAY SPECIFY THE DIMENSION IN 
BRACKETS FOLLOWING THE Q (OR THE *) SYMBOL, 

THE LEFT ARGUMENT MUST HAVE THE SAME SHAPE AS THE RIGHT ARGUMENT 

OMITTING THE DIMENSION BEING ROTATED OVER, OR IT MAY BE A SCALAR 
FOR EXAMPLE , TO ROTATE OVER THE ROWS OF A THREE-DIMENSIONAL ARRAY 
CALLED AA WHERE f A A => 2 3 4f ENTER EITHER S$[2j aa of *$C2] aa 
WHERE f M -> 2 4* TO ROTATE OVER THE PAGES, ENTER SqAA OR MqAA 
OR S #[11 AA OR M$Q]AA WHERE fM => 3 4, TO ROTATE OVER THE 
COLUMNS, ENTER SJ)AA OR M0 A A OR 5e[3]AG OR Me[3]AA WHERE fM = > 2 
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ROTATE 



ROT1 



♦ ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ft* ® 

THE SYMBOL 9 ( ALT 7) IS USED FOR THE DYADIC ROTATE FUNCTION, 

THE RIGHT ARGUMENT CAN BE CHARACTER OR NUMERIC , OF AMY RANK, 

THE LEFT ARGUMENT MUST BE AN INTEGER SCALAR OR ARRAY, 

IT RETURNS ALL THE ELEMENTS OF THE RIGHT ARGUMENT IN THE SAME SHAPE, 
BUT IN A DIFFERENT ORDER, AS FOLLOWS, 

USING 9 WITH TWO SCALAR ARGUMENTS SIMPLY RETURNS THE RIGHT ARGUMENT, 

A VECTOR RIGHT ARGUMENT REQUIRES A SCALAR LEFT ARGUMENT, 

EACH ELEMENT OF THE RIGHT ARGUMENT IS MOVED TO THE LEFT BY THE NUMBER 
UF PLACES INDICATED IN THE LEFT ARGUMENT, 

for example; 2^2 35 => 523 39 ‘ rotate 1 => aterqt 

WHEN USED WITH A MATRIX, 9 TAKES EITHER A SCALAR LEFT ARGUMENT OR A 
VECTOR WITH AS MANY ELEMENTS AS THERE ARE COLUMNS IN THE MATRIX, 
Sqm TAKES THE ROWS AS UNITS AND MOVES EACH ROW UP BY THE NUMBER- 
SPACES INDICATED BY THE SCALAR, 
for example: IF M = > 123 THEN 2Q m => 739 

4 5 6 1 2 3 

7 3 9 4 5 6 

V$M TAKES EACH COLUMN INDIVIDUALLY AND MOVES THE ELEMENTS UP BY 

THE NUMBER OF SPACES INDICATED BY THE CORRESPONDING ELEMENT OF THE 
LEFT ARGUMENT, FOR EXAMPLE} 

2 3 1 S M — > 7 2 6 THE FIRST COLUMN IS MOVED 2 SPACES UP 

159 THE SECOND COLUMN IS ROTATED 3 SPACES 

483 THE THIRD COLUMN IS ROTATED ONCE 

EACH ELEMENT IS IN THE SAME COLUMN BUT A DIFFERENT ROW, SO APL 
USERS REFER TO THIS AS WORKING 'ACROSS* OR 'OVER' THE ROWS, 

SINCE ROWS ARE THE FIRST OF TWO DIMENSIONS OF A MATRIX, 

THIS MEANS THAT THE SYMBOL 9 WORKS 'OVER' THE FIRST DIMENSION, 

TO ROTATE OVER THE LAST DIMENSION (E,G, COLUMNS OF A MATRIX), USE THE 
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SYMBOL $ (ALT J), IN PLACE OF a 



THIS IS IMPORTANT WHEN WORKING WITH HIGHER-DIMENSIONAL ARRAYS, 

FOR EXAMPLE, IN A THREE-DIMENSIONAL ARRAY OF PAGES, ROWS, AND 
COLUMNS, $ WILL ROTATE OVER THE COLUMNS, Q OVER THE PAGES, 

TO ROTATE OVER ANY DIMENSION, YOU MAY SPECIFY THE DIMENSION IN 
BRACKETS FOLLOWING THE 0 (OR THE $ ) SYMBOL, 

THE LEFT ARGUMENT MUST HAVE THE SAME SHAPE AS THE RIGHT ARGUMENT 

OMITTING THE DIMENSION BEING ROTATED OVER, OR IT MAY BE A SCALAR, 
FOR EXAMPLE, TO ROTATE OVER THE ROWS OF A THREE-DIMENSIONAL ARRAY 
CALLED AA WHERE f A A => 2 3 4? ENTER EITHER S$[2] AA OR M <DC2] AA 

WHERE f M =>2 4* T0 ROTATE OVER THE PAGES, ENTER S 0 A A OR M g A A 
OR 5,j)Cl]AA OR M$[i]AA WHERE /■ M => 3 4 , TO ROTATE OVER THE 
COLUMNS, ENTER B$AA OR M(J)AA OR Sq[3]AA OR Mq[3]AA WHERE fM => 2 3* 
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TRANSPOSE-MONADIC 



TRAM 



♦ «♦#♦♦♦»*»•*»»*•••♦»»»»»♦»»»♦»«»*» 
THE SYMBOL $ (ALT £) IS USED FOR THE MONADIC TRANSPOSE FUNCTION, 

IT TAKES NUMERIC OR CHARACTER ARGUMENTS OF ANT RANK, 

IT RETURNS ALL THE ELEMENTS OF THE ARGUMENT IN A DIFFERENT SHAPE 
AND ORDER, AS FOLLOWS, 



USING § WITH A SCALAR OR VECTOR SIMPLY RETURNS THE ARGUMENT, 



WHEN USED WITH A MATRIX, $ PERFORMS MATRIX TRANSPOSITION} 
THE ROWS BECOME COLUMNS AND THE COLUMNS BECOME ROWS, 



FOR EXAMPLE, IF M => j. 


2 


3 


THEN 


§M 


= > 


l 


4 


7 


4 


5 


6 








2 


5 


8 


7 


3 


9 








3 


6 


9 



WHEN USED WITH HI GHER -DI MENS I ONAL ARRAYS, TRANSPOSE REVERSES THE 
ORDER OF THE DIMENSIONS, 

FOR EXAMPLE, IN A THREE-DIMENSIONAL ARRAY OF PAGES, ROWS, AND 
COLUMNS, THE PAGES WILL BECOME ROWS AND THE ROWS PAGES, 

THAT IS, THE ELEMENT IN THE FIRST PAGE, SECOND ROW, THIRD COLUMN 
WILL BE TRANSPOSED TO THE THIRD PAGE, SECOND ROW, FIRST COLUMN, 

IF a r r a y [ i j 2 7 3 f 4 ] =) 7 them ($arrat) C4f3f2J 13 => 7 

THE SHAPE OF THE RESULT WILL ALWAYS BE THE REVERSE OF THE SHAPE OF 
THE ARGUMENT, IF f ARRAY => 3 2 7 THEN f § A R R A Y = > 723 
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TRANSPOSE- B ‘7’ ABIC 



TRAD 






♦ ♦♦♦♦♦♦♦ 



*3 









THE SYMBOL $ (ALT £ ) IS USED FOR THE DYADIC TRANSPOSE FUNCTION f 
THE RIGHT ARGUMENT CAN BE CHARACTER OR NUMERIC, OF ANY RANK, 
THE LEFT ARGUMENT MUST BE A POSITIVE INTEGER SCALAR OR VECTOR, 
IT RETURNS ALL THE ELEMENTS OF THE RIGHT ARGUMENT IN A DIFFERENT 
SHAPE AND ORDER, AS FOLLOWS, 



USING $ WITH A SCALAR RIGHT ARGUMENT RETURNS A ' LENGTH ERROR* UNLESS 
THE LEFT ARGUMENT IS AN EMPTY VECTOR, THEN IT RETURNS THE SCALAR, 



1$V RETURNS THE VECTOR V, ANY OTHER SCALAR LEFT ARGUMENT USED WITH 
A VECTOR RIGHT ARGUMENT PRODUCES A * DOMAIN ERROR', ANY OTHER 
RANK LEFT ARGUMENT RESULTS IN A 'LENGTH ERROR', 

WITH A MATRIX RIGHT ARGUMENT. THE LEFT ARGUMENT MUST BE A VECTOR; 
EITHER (1 2) 0F; (2 1)* (2 1)§M PRODUCES THE TRANSPOSE OF H$ 

THE COLUMNS (THE SECOND DIMENSION) BECOME THE ROW (THE FIRST 
DIMENSION), (1 2)§ M => M 

WITH A RIGHT ARGUMENT OF RANK R, THE LEFT ARGUMENT MUST CONTAIN ALL 
THE INTEGERS FROM l TO R, IN ANY ORDER, 

TRANSPOSE WILL TAKE THE DIMENSIONS OF THE RIGHT ARGUMENT AND PUT THEM 
IN THE ORDER SPECIFIED BY THE LEFT ARGUMENT, 

FOR EXAMPLE, IF f A =>234 THEM (3 1 2)*A WILL PUT THE THIRD 

DIMENSION FIRST (COLUMNS BECOME PAGES), THE FIRST DIMENSION SECOND 
(PAGES BECOME ROWS), AND THE SECOND DIMENSION THIRD (ROWS BECOME 

columns), so f ( 3 i 2 )$a => 423 * 

IN OTHER WORDS, THE ELEMENT IN THE SECOND COLUMN, THIRD ROW, FIRST 
PAGE WILL BE TRANSPOSED TO THE SECOND PAGE, THIRD COLUMN, FIRST 
ROW, AND SO ON, IF A [ 1 3 2] => 3 THEM ((3 1 2)^)L2 133 => 8* 
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TAKE 



TAKE 



THE SYMBOL f (UPSHIFT Y) IS USED FOR THE DYADIC TAKE FUNCTION, 

THE LEFT ARGUMENT MUST BE AN INTEGER SCALAR OR VECTOR, 

THE RIGHT ARGUMENT CAN BE CHARACTER OR NUMERIC, OF ANY RANK, 

TAKE RETURNS SELECTED ELEMENTS OF THE RIGHT ARGUMENT AS FOLLOWS ♦ 

WHEN THE RIGHT ARGUMENT IS A SCALAR, THE LEFT ARGUMENT CAN BE A SCALAR 
OR A VECTOR OF ANY LENGTH, 

THE RESULT OF LfR HAS A SHAPE EXACTLY EQUAL TO L, R WILL BE THE FIRST 
ELEMENT IF L IS POSITIVE, AND THE LAST ELEMENT IF L IS NEGATIVE, THE 
OTHER ELEMENTS WILL BE 0 IF R 15 HUMERIC, BLANK IF R IS CHARACTER, 
FOR EXAMPLE ♦ if 4 => 4 Plf4 => 1 2f ' A 1 = > A 

rz *'* 1 = > 2 “4*2 => 0002 f ( 3 4)fl =>34 

IF THE RIGHT ARGUMENT IS A VECTOR, THE LEFT ARGUMENT MUST BE A SCALAR 
OR A * RANK ERROR* WILL RESULT, 

SfV WILL RETURN THE FIRST S ELEMENTS OF V, IF S IS POSITIVE, OR THE 
LAST S ELEMENTS OF V, IF S IS NEGATIVE, 

IF S EXCEEDS THE LENGTH OF V, THE RESULT WILL BE PADDED WITH 0*S, 0F: 
BLANKS, ON THE RIGHT IF S IS POSITIVE, ON THE LEFT IF S IS NEGATIVE, 

for example; 3 f \ l 0 => 12 3 ~3f 1 alphabet * => bet 

5f'ABC => ABC fSt'ABC s > 5 “ 4 * 2 3 => 0 0 2 3 

WHEN THE RIGHT ARGUMENT IS A MATRIX OR HIGHER LEVEL ARRAY, THE LEFT 

ARGUMENT MUST BE A VECTOR WITH AS MANY ELEMENTS AS THERE ARE 
DIMENSIONS IN THE RIGHT ARGUMENT, OR A 'LENGTH ERROR* RESULTS, 

FOR example; if m => 937 ”1 2*» =>65 2 4f» => 9870 

6 5 4 6 5 4 0 

THE FIRST ELEMENT OF THE VECTOR DETERMINES WHICH ROWS ARE TAKEN, 

AND THE SECOND ELEMENT DETERMINES WHICH COLUMNS ARE TAKEN, 

THE RESULT WILL BE PADDED WITH Q'S OR BLANKS AS ABOVE, 
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FOR HIGHER LEVEL ARRAYS, EACH ELEMENT OF THE LEFT ARGUMENT WILL 
TAKE ELEMENTS FROM THE CORRESPONDING DIMENSION, 

FOR EXAMPLE, IF f A ~> £ 5 4 } (2 ”3 1 ) fM WILL RETURN THE FIRST 

COLUMN OF THE LAST THREE ROWS OF THE FIRST TWO PAGES, 

THE RESULT OF TAKE WILL ALWAYS HAVE A SHAPE EXACTLY EQUAL TO THE 
ABSOLUTE VALUE OF THE LEFT ARGUMENT, 

IF THERE IS A ZERO (0) ANYWHERE IN THE LEFT ARGUMENT • THE ANSWER WILL 
BE AN EMPTY ARRAY WITH THE APPROPRIATE SHAPE, 

FOR EXAMPLE ♦ j> 2 ”3 It* =>2 3 1 ;7 0 7fA => 7 0 7 
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DROP 



DROP 



THE SYMBOL 4 (UPSHIFT U) IS USED FOR THE DYADIC DROP FUNCTION, 

THE LEFT ARGUMENT MUST BE AH INTEGER SCALAR OR VECTOR , 

THE RIGHT ARGUMENT CAN BE CHARACTER OR NUMERIC, OF ANY RANK, 

DROP RETURNS SELECTED ELEMENTS OF THE RIGHT ARGUMENT AS FOLLOWS* 

WHEN THE RIGHT ARGUMENT IS A SCALAR, THE LEFT ARGUMENT CAN BE A SCALAR 
OR A VECTOR OF ANY LENGTH, 

IF ALL ELEMENTS OF THE LEFT ARGUMENT EQUAL Q , THE RESULT OF L±S WILL 
BE AN ARRAY CONTAINING THE RIGHT ARGUMENT} OTHERWISE IT WILL BE AN 
EMPTY ARRAY t THIS ARRAY HAS AS MANY DIMENSIONS AS THE LEFT ARGUMENT 
HAS ELEMENTS AND EACH DIMENSION IS OF LENGTH 1, 

for example; 144 => (empty) fH4 => 1 04' A ' => A 

2 4 642 = > (EMPTY) f ( 2 4 6)42 =>111 0 0 043 => 3 

IF THE RIGHT ARGUMENT IS A VECTOR, THE LEFT ARGUMENT MUST BE A SCALAR 
OR A 'RANK ERROR' WILL RESULT, 

S|V WILL RETURN V OMITTING THE FIRST S ELEMENTS, IF 5 IS POSITIVE, 

OR. THE LAST S ELEMENTS, IF S IS NEGATIVE, 

IF S EXCEEDS THE LENGTH OF V, THE RESULT WILL BE AN EMPTY VECTOR, 

for example; 64\1Q => 7 3 9 10 "34 ' alphabet 1 => alpha 

54 1 ABC ' => (EMPTY) f54‘ABC => o 041 3 => 1 3 

WHEN THE RIGHT ARGUMENT IS A MATRIX OR HIGHER LEVEL ARRAY, THE LEFT 
ARGUMENT MUST BE A VECTOR WITH AS MANY ELEMENTS AS THERE ARE 
DIMENSIONS IN THE RIGHT ARGUMENT, OR A 'LENGTH ERROR* RESULTS, 

FOR example; IF m => 9 3 7 i ~i4M =>65 0 24* => 7 

6 5 4 4 

THE FIRST ELEMENT OF THE VECTOR DETERMINES WHICH ROWS ARE DROPPED, 

AND THE SECOND ELEMENT DETERMINES WHICH COLUMNS ARE DROPPED, 

FOR HIGHER LEVEL ARRAYS, EACH ELEMENT OF THE LEFT ARGUMENT WILL 
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DROP ELEMENTS FROM THE CORRESPONDING DIMENSION, 

FOR EXAMPLE 1 IF fA => 6 5 4? (2 ~3 1 ) |A WILL RETURN THE LAST 

THREE COLUMNS OF THE FIRST TWO ROWS OF THE LAST FOUR PAGES, 

THE RESULT OF DROP WILL ALWAYS HAVE A SHAPE EXACTLY EQUAL TO THE 
SHAPE OF THE RIGHT ARGUMENT MINUS THE ABSOLUTE VALUE OF THE 
LEFT ARGUMENT, EXCEPT AS FOLLOWS; 

IF ANY ELEMENT OF THE LEFT ARGUMENT EXCEEDS THE LENGTH OF THE 

CORRESPONDING DIMENSION IN THE RIGHT ARGUMENT , THE RESULT WILL 



BE AN EMPTY ARRAY OF THE APPROPRIATE SHAPE. 



IN THE ABOVE EXAMPLE; 

f ( 3 4 5 ) i => 310 



f (2 



”3 1HA 
3 4 5+* 



= > 



4 2 3 

(EMPTY) 
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COMPRESS 



COMO 



THE SYMBOL / IS USED FOR THE DYADIC COMPRESS FUNCTION, 

THE RIGHT ARGUMENT CAN BE CHARACTER OR NUMERIC, OF ANY RANK, 

THE LEFT ARGUMENT MUST BE l,Q 9 OR A VECTOR OF J'S AND O’ 5* 

COMPRESS RETURNS SELECTED ELEMENTS OF THE RIGHT ARGUMENT, AS FOLLOWS { 

1/A WILL RETURN THE RIGHT ARGUMENT, WHILE Q/A RETURNS AN EMPTY ARRAY, 

V1/V2 WILL RETURN THE ELEMENTS OF V'2 THAT CORRESPOND TO 1'3 IN V , 

FOR example: 101/123 => 13 110 I/'halt* => hat 

TWO VECTOR ARGUMENTS MUST HAVE THE SAME NUMBER OF ELEMENTS OR A 
'LENGTH ERROR* WILL RESULT, 

V/M TAKES THE COLUMNS AS UNITS AND RETURNS THE COLUMNS IN M WHICH 
CORRESPOND TO THE I'S IN V, FOR EXAMPLE* 

IP M => 123 THEN 1 0 1/M => 13 

4 5 6 4 6 

7 3 9 7 9 

APL USERS REFER TO THIS AS WORKING 'ACROSS' OR 'OVER' THE COLUMNS, 
SINCE COLUMNS ARE THE SECOND OF TWO DIMENSIONS OF A MATRIX, 

THIS MEANS THAT THE SYMBOL / WORKS 'OVER' THE LAST DIMENSION, 

TO COMPRESS OVER THE FIRST DIMENSION ( E , G , ROWS OF A MATRIX), USE THE 
SYMBOL / (ALT /), IN PLACE OF /, 

THIS IS IMPORTANT WHEN WORKING WITH HIGHER-DIMENSIONAL ARRAYS, 

FOR EXAMPLE, IN A THREE-D I MENS I ON AL ARRAY OF PAGES, ROWS, AND 
COLUMNS, / WILL COMPRESS OVER THE COLUMNS, / OVER THE PAGES, 

TO COMPRESS OVER ANY DIMENSION, YOU MAY SPECIFY THE DIMENSION IN 
BRACKETS FOLLOWING THE / (OR THE /) SYMBOL, 

THE LEFT ARGUMENT MUST BE A SCALAR, OR A VECTOR WITH THE SAME 
NUMBER OF ELEMENTS AS THE DIMENSION BEING COMPRESSED OVER, 

FOR EXAMPLE, TO COMPRESS OVER THE ROWS OF A THREE-DIMENSIONAL ARRAY 
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CALLED AA WHERE f A A = 

OP: V/[2] AA WHERE f V = > 
5/6 A OR V /' A 6 OR 5 / [ 1 ] A A 
OVER THE COLUMNS, ENTER 
WHERE fV => 



> 2 3 4 y enter 5/[2]aa 

3* TO COMPRESS 
OR V/C13AA WHERE 
S/AA 



OR V/C23 AA OR 5 /C23AA 

THE PAGES, ENTER 

2, TO COMPRESS 
OR V/C 33 AA 



OVER 

f v = > 

OR V/ AA OR S/C33AA 
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COMPRESS 



COM| 



THE SYMBOL / (ALT /) IS USED FOR THE DYADIC COMPRESS FUNCTION, 

THE RIGHT ARGUMENT CAN BE CHARACTER OR NUMERIC , OF ANY RANK, 

THE LEFT ARGUMENT MUST BE 1 , Q, OR A VECTOR OF \'S AND 0' s » 

COMPRESS RETURNS SELECTED ELEMENTS OF THE RIGHT ARGUMENT , AS FOLLOWS { 

1/A WILL RETURN THE RIGHT ARGUMENT, WHILE Q/A RETURNS AN EMPTY ARRAY, 

V1/V2 WILL RETURN THE ELEMENTS OF V2 THAT CORRESPOND TO 1*5 IN VJ, 

FOR example; 101/123 => 13 110 I/’halt* => hat 

TWO VECTOR ARGUMENTS MUST HAVE THE SAME NUMBER OF ELEMENTS OR A 
'LENGTH ERROR' WILL RESULT, 

V/M TAKES THE ROWS AS UNITS AND RETURNS THE ROWS IN M WHICH 
CORRESPOND TO THE J ■ S IN V, FOR EXAMPLE ♦ 

IF M => 123 THEN 1 o 1/M => 123 

4 5 6 7 8 9 

7 3 9 

APL USERS REFER TO THIS AS WORKING 'ACROSS* OR 'OVER* THE ROWS, 

SINCE ROWS ARE THE FIRST OF TWO DIMENSIONS OF A MATRIX, 

THIS MEANS THAT THE SYMBOL / WORKS 'OVER* THE FIRST DIMENSION, 

TO COMPRESS OVER THE LAST DIMENSION ( E , G , COLUMNS OF A MATRIX), 

USE THE SYMBOL / IN PLACE OF /, 

THIS IS IMPORTANT WHEN WORKING WITH HIGHER-DIMENSIONAL ARRAYS, 

FOR EXAMPLE, IN A THREE-DIMENSIONAL ARRAY OF PAGES, ROWS, AND 
COLUMNS, / WILL COMPRESS OVER THE COLUMNS, / OVER THE PAGES, 

TO COMPRESS OVER ANY DIMENSION, YOU MAY SPECIFY THE DIMENSION IN 
BRACKETS FOLLOWING THE / (OR THE /) SYMBOL, 

THE LEFT ARGUMENT MUST BE A SCALAR, OR A VECTOR WITH THE SAME 
NUMBER OF ELEMENTS AS THE DIMENSION BEING COMPRESSED OVER, 

FOR EXAMPLE, TO COMPRESS OVER THE ROWS OF A THREE-DIMENSIONAL ARRAY 
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CALLED A A WHERE ffiw => 2 3 4f ENTER S/[2]AA OR V/[2]AA OR S/[2]AA 

OR V/[2] AA WHERE fV = > 3, TO compress over the pages, enter 
S/AA OR V/AA OR S/[i]AA OR V/[1]AA WHERE fV = > 2 ♦ TO COMPRESS 
OVER THE COLUMNS, ENTER S/AA OR V/AA OR S/[3] AA OR V/[3] AA 
WHERE fV => 4, 
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EXPAND 



EXPO 



******************************* \ ********************************* 
THE SYMBOL \ (UPSHIFT /) IS USED F OF: THE DYADIC EXPAND FUNCTION, 

THE RIGHT ARGUMENT CAN BE CHARACTER OR NUMERIC, OF ANY RANK, 

THE LEFT ARGUMENT MUST BE A VECTOR OF i'S AND 0'S, 

IS NUMERIC, OR BLANKS IF IT IS CHARACTER, AS FOLLOWS: 

EXPAND RETURNS THE RIGHT ARGUMENT, ADDING Q' s IF THE RIGHT ARGUMENT 
IS NUMERIC, OR: BLANKS IF IT IS CHARACTER, AS ROLLONS* 

V\ 5 WILL RETURN A VECTOR CONSISTING OF THE SCALAR REPEATED AS MANY 



TIMES AS 


THERE 


ARE 1 ' S 


IN V, 


for example; 


1 0 


i\3 => 


3 3 


IF THERE ARE 


NO l 1 


1 S IN V , 


V\S RETURNS AN EMPTY VECTOR, 



V1/V2 WILL RETURN THE ELEMENTS OF V2, WITH 0'S BLANKS INSERTED 

TO CORRESPOND TO THE A'5 IN VI, FOR EXAMPLE* 

1 1 0 1\1 2 3 => 1 2 0 3 1 0 1 0 1 \ 1 A R L 1 => A P L 

THE LEFT ARGUMENT MUST CONTAIN AS MANY I'S AS THERE ARE ELEMENTS 
IN THE RIGHT ARGUMENT uR A 'LENGTH ERROR ' WILL RESULT, 

V\M TAKES THE COLUMNS AS UNITS AND RETURNS THE A MATRIX WITH COLUMN 
OF 0'S OR BLANKS INSERTED TO CORRESPOND TO THE i'S IN V, 



IF M => 1 


2 


3 


THEN 


1 0 1 0 1\m => 1 


0 


n 


0 


3 


4 


5 


6 




4 


0 


r 


0 


6 


7 


8 


9 




7 


0 


3 


0 


9 



APL USERS REFER TO THIS AS WORKING 'ACROSS' OR 'OVER* THE COLUMNS, 
SINCE COLUMNS ARE THE SECOND OF TWO DIMENSIONS OF A MATRIX, 

THIS MEANS THAT THE SYMBOL \ WORKS 'OVER' THE LAST DIMENSION, 

TO EXPAND OVER THE FIRST DIMENSION ( E , G , ROWS OF A MATRIX), USE THE 
SYMBOL \ (ALT ,), IN PLACE OF \, 

THIS IS IMPORTANT WHEN WORKING WITH H I 5HER -D I MENS I ON AL ARRAYS, 

FOR EXAMPLE, IN A THREE-DIMENSIONAL ARRAY OF PAGES, ROWS, AND 
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COLUMNS, \ WILL EXPAND OVER THE COLUMNS, \ OVER THE PAGES, 

TO EXPAND OVER ANY DIMENSION, YOU MAY SPECIFY THE DIMENSION IN 
BRACKETS FOLLOWING THE \ (OR THE \) SYMBOL, 

FOR EXAMPLE , TO EXPAND OVER THE ROWS OF A THREE-DIMENSIONAL ARRAY 
CALLED AA WHERE f A A =>2 3 A 7 ENTER V\[2] AA 0R V \C2] AA 
WHERE +/V => 3, TO EXPAND OVER THE PAGES, ENTER V \ A A OR V\[1]AA 

WHERE +/V = > 2* T0 EXPAND OVER THE COLUMNS, ENTER V\AA OR 

V\£3]AA WHERE + /V = > 4 
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E X P A N D 



pi 



THE SYMBOL \ (ALT , ) IS USED FOR THE DYADIC EXPAND FUNCTION , 

THE RIGHT ARGUMENT CAN BE CHARACTER OR NUMERIC, OF ANY RANK, 

THE LEFT ARGUMENT MUST BE A VECTOR OF \ 1 S AND Q'S, 

EXPAND RETURNS THE RIGHT ARGUMENT, ADDING Q'S IF THE RIGHT ARGUMENT 
IS NUMERIC, OR BLANKS IF IT IS CHARACTER, AS FOLLOWS ♦ 

V\S WILL RETURN A VECTOR CONSISTING OF THE SCALAR REPEATED AS MANY 
TIMES AS THERE ARE i'S IN V, 

for example: i o i\3 => 33 

IF THERE ARE NO I'S IN V, V\5 RETURNS AN EMPTY VECTOR , 

VJ\V2 WILL RETURN THE ELEMENTS OF V2? WITH 0'5 OR BLANKS INSERTED 
TO CORRESPOND TO THE 0' E IN V£, FOR EXAMPLE J 

1 1 0 Ihl 2 3 => 1 2 0 3 1 0 1 0 1VAPL' => a p l 

THE LEFT ARGUMENT MUST CONTAIN AS MANY 1 ' S AS THERE ARE ELEMENTS 
IN THE RIGHT ARGUMENT OR A 'LENGTH ERROR* WILL RESULT , 

V V M TAKES THE ROWS AS UNITS AND RETURNS THE MATRIX WITH ROWS 
OF 0'S OR BLANKS INSERTED TO CORRESPOND TO THE I'S IN V, 

IF M = > 123 then 1 0 1 \ M = > 123 

4 5 6 0 0 0 

4 5 6 

APL USERS REFER TO THIS AS WORKING ‘ACROSS' OR 'OVER' THE ROWS, 
SINCE ROWS ARE THE FIRST OF TWO DIMENSIONS OF A MATRIX, 

THIS MEANS THAT THE SYMBOL \ WORKS 'OVER' THE FIRST DIMENSION, 

TO EXPAND OVER THE LAST DIMENSION ( E , G , COLUMNS OF A MATRIX) , USE 
THE SYMBOL \ (UPSHIFT /), IN PLACE OF 

THIS IS IMPORTANT WHEN WORKING WITH HIGHER-DIMENSIONAL ARRAYS, 

FOR EXAMPLE, IN A THREE-DIMENSIONAL ARRAY OF PAGES, ROWS, AND 
COLUMNS, \ WILL EXPAND OVER THE COLUMNS, \ OVER THE PAGES, 
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TO EXPAND OVER ANY DIMENSION, YOU MAY SPECIFY THE DIMENSION IN 
BRACKETS FOLLOWING THE \ (Oft THE \) SYMBOL, 

THE LEFT ARGUMENT MUST BE A VECTOR WITH THE SAME NUMBER OF 5 AS 
THERE ARE ELEMENTS IN THE DIMENSION BEING EXPANDED OVER , 

FOR EXAMPLE, TO EXPAND OVER THE ROWS OF A THREE-DIMENSIONAL ARRAY 
CALLED AA WHERE f A A =>234? ENTER V\[2]AA OR V\[2]AA 
WHERE +/V = > 3, TO EXPAND OVER THE PAGES, ENTER VVAfi OR V\[JJA 
WHERE x/V = > 2* TO EXPAND OVER THE COLUMNS, ENTER V\AA OR 

V HC3]AA WHERE +/V => 4 
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LAMINATE 



LAMI 



THE SYMBOL , FOLLOWED BY AM HUMBER IN BRACKETS IS USED FOR THE 

DYADIC LAMINATE FUNCTION, AN EXTENSION OF THE CATENATE FUNCTION, 
THIS FUNCTION WILL COMBINE TWO CHARACTER OR NUMERIC ARGUMENTS 
OF ANY RANK (EXCEPT TWO SCALARS) INTO A SINGLE ARRAY, 

VECTORS CAN BE EXTENDED BY LAMINATING S , [ 1 ] V OR V,[l]5 OR V,£i]V, 

THE NUMBER IN THE BRACKETS MUST BE 1 BECAUSE VECTOR HAVE ONLY 
ONE DIMENSION, THIS WORKS EXACTLY LIKE CATENATE, 

NOW FOR SOMETHING REALLY TFICKTJ 

TO MAKE A TWO-ROW MATRIX OUT OF TWO VECTORS OF THE SAME LENGTH, 
ENTER V 1 , [ , F ] V 2 , ANY INDEX BETWEEN Q AND i WILL DO, 

THIS CREATES A NEW DIMENSION PRECEDING THE FIRST DIMENSION OF 
THE ARGUMENTS, THE OTHER DIMENSION STAYS THE SAME LENGTH, 

TO MAKE A TWO-COLUMN MATRIX, ENTER Vl,d,5]V2 (ANY INDEX FROM 1 TO 2)* 
NOW THE NEW DIMENSION COMES AFTER THE FIRST, WHICH IS THE SAME AS 
THE LENGTH OF THE ARGUMENTS, 

LAMINATING A SCALAR TO A MATRIX WILL RESULT IN A MATRIX WITH ONE 
MORE ROW (IF THE INDEX NUMBER IN BRACKETS IS i) OR ONE MORE 
COLUMN (IF THE INDEX NUMBER IS 2) THAN THE ORIGINAL MATRIX, 



ENTRIES 


IN THIS ROW 


OF: COLUMN WILL 


HAVE THE 


VALUE OF THE 


SCALAR 


IF M - 


> i 2 then 


=> 5 


5 AND 


w,C2]5 => 1 


2 5 




3 4 


1 


o 


7 

vJ 


4 5 






3 


4 







LAMINATING TWO MATRIXES WILL RESULT IN A MATRIX CONTAINING THE TWO 

ORIGINAL MATRIXES SIDE BY SIDE (INDEX 2) VERTICALLY (INDEX 1), 

for example; if mi => i 2 and M2 => 5 6 

3 4 7 8 

THEN M1,C2]W2 => 1256 and M2,[1]M1 => i 2 
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3 4 7 3 



3 4 
5 6 



7 3 

TO STACK THE MATRIXES BY CREATING A THIRD DIMENSION, ENTER 

M ly[ + 53 M 2 (ANT INDEX BETWEEN 0 AND i), YOU CAN ALSO CREATE 
A THIRD DIMENSION BY Ml, Cl . 5 3 M 2 op: m 1jC2*53 m 2. TRY 

VARIATIONS ON THIS THEME ARE ALMOST ENDLESS — EXPERIMENT J 
IN EVERY CASE, THE NUMBER IN THE BRACKETS REFERS TO THE DIMENSION 
WHERE THE 1 SEAM 1 I S — THE DIMENSION THAT INCREASES IN LENGTH, 

IF THIS IS A NEW DIMENSION, IT WILL ALWAYS BE LENGTH 2 IN THE RESULT, 
THE OTHER DIMENSIONS MUST BE THE SAME LENGTH IN DOTH ARGUMENTS 
(UNLESS ONE IS A SCALAR) OR A 'LENGTH ERROR' WILL RESULT, 
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WAT I 



MATRIX INVERSE 



♦ ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦I****** u ******•**»*•»*****•***«»•*»•** + »«** 

THE SYMBOL g ( ALT X) 15 USED FOR THE MONADIC MATRIX INVERSE FUNCTION, 
IT TAKES A NUMERIC SCALAR , VECTOR, OR MATRIX ARGUMENT , AND RETURNS 
THE LEFT INVERSE, IN TERMS OF MATRIX ALGEBRA, THIS IS THE MATRIX 
WHICH PRODUCES THE IDENTITY WHEN LEFT-MULTIPLIED WITH THE ORIGINAL, 

WHEN USED WITH SCALARS, Q IS EQUIVALENT TO i. 



g WILL TREAT VECTORS AS 1*L MATRIXES, QV WILL RETURN THE VECTOR VI 
SO THAT VI +,x V => 1 

SQUARE MATRIXES WILL BE INVERTED NORMALLY, 

FOR EXAMPLE ♦ IF M =) 12 3 M => ”2 1 

3 4 1.5 "0.5 



SOME NON-SQUARE MATRIXES MAY ALSO BE INVERTED 



FOR EXAMPLE] 



IF M2 => 14 THEM gM2 => 



3 6 



'0*9444 •0.1111 
0,4444 0*1111 



IF M IS NOT INVERTIBLE, A 'DOMAIN ERROR 1 WILL RESULT, 



0*7222 

" 0*2222 
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MATRIX DIVIDE 



M AT D 



**»««*«»»▼»»»»«»♦«»»«*«**»*»*«» d ♦ ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦»*♦♦♦ 
THE SYMBOL g (ALT x) IS USED FOR THE DYADIC MATRIX DIVIDE FUNCTION, 

IT TAKES ARITHMETIC ARGUMENTS WITH RANK < 3 , THE TWO ARGUMENTS 

MUST HAVE THE SAME NUMBER OF ROWS, 

IN TERMS OF MATRIX ALGEBRA, IT LEFT MULTIPLIES THE LEFT ARGUMENT BY 
THE LEFT INVERSE OF THE RIGHT ARGUMENT, 

B£A PRODUCES THE SOLUTION TO THE SET OF LINEAR EQUATIONS AX=B, 

WHEN USED WITH TWO SCALARS, 0 IS EQUIVALENT TO 

WHEN USED WITH VECTORS, g OPERATES AS IF THE VECTORS ARE \xC OR Rxl 
MATRIXES, WHICHEVER IS APPROPRIATE, 
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OUTER PRODUCT 



OUTE 



THE SYMBOLS (UPSHIFT J FOLLOWED BY A PERIOD) ARE PLACED PRECEDING 

AMY DYADIC FUNCTION SYMBOL TO PRODUCE THE OUTER PRODUCT FUNCTION, 
THE ARGUMENTS MAY BE NUMERIC OR CHARACTER, IF THE DYADIC SYMBOL 

ACCEPTS CHARACTER ARGUMENTS , THEY MAY BE OF ANY RANK AND DO HOT 
HAVE TO AGREE IN SHAPE, 

THE OUTER PRODUCT RESULTS IN THE DYADIC SYMBOL OPERATING ON EACH 
ELEMENT OF THE LEFT ARGUMENT COMBINED WITH EVERY ELEMENT OF 
THE RIGHT ARGUMENT, 

FOR example; 1 2 °*x 3 4 5 => 3 4 5 

6 8 10 

'STOP' o,= 1 post ■ = > 0 0 10 

0 0 0 1 
0 10 0 
10 0 0 

OUTER PRODUCT (ALSO CALLED 'JOT DOT' BECAUSE OF THE S'tMBOLS) 

CAM BE EXTENDED TO ARRAYS Or AMY DIMENSION CR SICE, 

THE SHARE OF THE RESULT WILL ALWAYS BE EQUAL TO THE SHAPE OF THE 
LEFT ARGUMENT CATENATED TO THE SHAPE OF THE RIGHT ARGUMENT, 

FOR EXAMPLE J IF fAl => 34 AND />A2 => 6 5 
THEN fAlo,+A2 => 3465 
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INNER PRODUCT 



INNE 



***************************** ♦ *♦***♦♦*♦*♦*♦**♦**♦♦♦♦♦*♦*♦***♦♦* 

THE SYMBOL , (PERIOD OR 'DOT 1 ) MAY BE PLACED BETWEEN ANY TWO DYADIC 

FUNCTION SYMBOLS TO CREATE THE INNER PRODUCT FUNCTION, 

THE ARGUMENTS MAY BE NUMERIC OR CHARACTER, IF APPROPRIATE, OF ANY 
RANK, THE LENGTH OF THE LAST DIMENSION OF THE LEFT ARGUMENT 
MUST BE THE SAME AS THE LENGTH OF THE FIRST DIMENSION OF THE 
RIGHT ARGUMENT, 

INNER PRODUCT IS MOST COMMONLY USED WITH + AND x TO FORM THE 

CONVENTIONAL DOT PRODUCT OR MATRIX PRODUCT OF MATRIX ALGEBRA, 

for example; if vi => 123 a x d V 2 => 4 5 6 

THEN VI +,X V2 => 32 

INNER PRODUCT MAY BE EXTENDED TO HIGHER LEVEL ARRAYS AS WELL AS 

MATRIXES, THE SHAPE OF THE RESULT WILL BE THE SAME AS THE SHAPE 
OF THE LEFT ARGUMENT CATENATED TO THE SHAPE OF THE RIGHT ARGUMENT, 
OMITTING THE MATCHING DIMENSIONS (LAST ON THE LEFT, FIRST ON 
THE RIGHT, 

for example; if fAi => 364 and fA2 = > 45 

THEN ? A1 +,v A2 => 365 
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301 



INDEX OF 



IN DO 



THE SYMBOL \ (UPSHIFT I) IS USED FOR THE DYADIC INDEX OF FUNCTION, 

THE LEFT ARGUMENT MUST BE A VECTOR AND THE RIGHT ARGUMENT CAN BE 
ANY RANK, INDEX OF CAN BE USED WITH CHARACTER OR NUMERIC DATA, 

IT RETURNS THE POSITION IN THE LEFT -ARGUMENT OF THE ELEMENTS OF THE 
RIGHT ARGUMENT, THE SHAPE OF THE RESULT IS THE SAME AS THE 
SHAPE OF THE RIGHT ARGUMENT „ 

IF THE RIGHT ARGUMENT DOES HOT OCCUR IN THE LEFT ARGUMENT, THE RESULT 
WILL BE ONE PLUS THE LENGTH OF THE LEFT ARGUMENT, 



FOR EXAMPLE J 


4 3 2 113 => 


2 


BECAUSE 


3 


IS IN THE SECOND POSITION 




1 HELLO ' \ 1 F' 1 = > 


6 


BECAUSE 


p 


IS NOT FOUND 



V \ A CHECKS EACH ELEMENT OF THE RIGHT ARGUMENT INDIVIDUALLY, 

for example: 357 9i 12345 => 55152 

IF YOU ASSIGN ALPHABET*-' ABCDEFGHI J K LMHOFQRST U VWKY Z • 
THEM ALPHABET \ 1 A P L 1 => 1 12 
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ENCODE 



ENCO 



♦ ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦it*** T »»*»»»*»*»*»♦*»*»»***+****»*»♦+**«• 

THE SYMBOL T (UPSHIFT N) IS USED FOR THE DYADIC ENCODE FUNCTION* 

IT TAKES NUMERIC ARGUMENTS OF ANY RANK AND RETURNS THE REPRESENTATION 
OF THE RIGHT ARGUMENT IN THE NUMBER SYSTEM SPECIFIED BY THE LEFT 
ARGUMENT * 

THE ENTRIES IN THE LEFT ARGUMENT DEFINE THE NUMBER OF VALUES THAT 
CAN BE PLACED IN THAT POSITION* 

FOR EXAMPLE, IN THE BINARY SYSTEM, EACH POSITION CAN TAKE ONE OF TWO 
VALUES, 0 1* THEREFORE, TO TRANSLATE 133 INTO BINARY, ENTER; 

2222222 2t133 => 10000101 

THE RESULT WILL ALWAYS BE THE SAME SHAPE AS THE LEFT ARGUMENT, SO BE 
SURE THAT THE LEFT ARGUMENT IS LARGE ENOUGH TO BE CORRECT* 

FOR example; 2 2 2x133 => 101 

ENCODE CAN ALSO BE USED TO TRANSLATE TIMES* GIVEN TIME IN SECONDS, 

enter (2000 365 24 60 60) t time to receive a vector of years 
(0 TO 1999), DAYS (0 TO 364) f HOURS (0 to 23) ? MINUTES (0 TO 60)? 
AND SECONDS ( Q TO 60)* 

FOR example; 2000 365 24 60 60x456701 => 0 5 6 51 41 
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305 



DECODE 



DECO 



»***»»»«♦*•««»♦«»*»»»*•»»* + »»»» l »♦♦♦♦ + ♦♦♦♦♦♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦»♦ 
THE SYMBOL ± (UPSHIFT B) IS USED FOF: THE DYADIC DECODE FUNCTION, 

IT TAKES NUMERIC ARGUMENTS OF ANY RANK AND RETURNS THE DECIMAL VALUE 
OF THE RIGHT ARGUMENT WHICH IS WRITTEN IN THE NUMBER SYSTEM- 
SPECIFIED BY THE LEFT ARGUMENT, 

THE ENTRIES IN THE LEFT ARGUMENT DEFINE THE VALUES OF EACH POSITION 
IN THE NUMBER SYSTEM, 

FOR EXAMPLE, IN THE BINARY SYSTEM, EACH POSITION CAN TAKE ONE OF TWO 
VALUES, 0 0R 1» THEREFORE, TO TRANSLATE 10000101 R *OM BINARY* 

2 i 1 0 0 0 0 1 0 1 => 133 

UNLESS ONE ARGUMENT IS A SCALAR, THE ARGUMENTS MUST BE THE SAME SHAPE 
OR A ‘LENGTH ERROR 1 WILL BE PRODUCED, 

DECODE CAN ALSO BE USED TO TRANSLATE TIMES, GIVEN TIME IN YEARS, 

(0 to 1999) f DftYS (0 to 364)? hours (q to 23) ? minutes (q to 60)? 
AND seconds (0 TO 60)? ehter 2000 365 24 60 60 ± time to 

FIND THE TIME IN SECONDS, 

roR example * 2000 365 24 60 60 x 0 5 6 51 41 => 456701 
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EXECUTE 



EXEC 



♦ ♦♦♦»♦♦♦♦♦♦♦♦♦♦♦♦♦»♦»♦♦♦♦♦♦♦♦*♦ i *♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ 
THE SYMBOL t (ALT [) IS USED FOR THE MONADIC EXECUTE FUNCTION, 
IT TAKES A VECTOR CHARACTER ARGUMENT ONLY, AND TREATS IT AS 
AN APL EXPRESSION, 



FOR example; 

IF V => 
HOWEVER , ± WILL 



±‘l + 2’ => 

'HELP ' jr *V 
HOT EXECUTE 



3 

WILL RUN THE HELP FUNCTION 
EXPRESSIONS BEGINNING WITH 



OR V* 
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format-dyadic 



DYFO 



♦ ♦♦♦*♦♦♦♦♦♦♦♦*♦♦*♦♦♦♦♦♦♦*♦♦♦♦♦♦ T ♦ ♦♦♦♦♦♦♦♦*♦♦♦♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦* 

THE SYMBOL t (ALT ]) IS USED FOR THE DYADIC FORMAT FUNCTION, 

THE RIGHT ARGUMENT MUST BE NUMERIC, OF ANY RANK, AND THE LEFT 
ARGUMENT MUST BE A VECTOR OF INTEGERS, 

THIS FUNCTION CONVERTS THE RIGHT ARGUMENT TO CHARACTER DATA IN 
A TABULAR FORMAT SPECIFIED BY THE LEFT ARGUMENT, AS FOLLOWS; 

IF THE LEFT ARGUMENT IS A SCALAR, THE RIGHT ARGUMENT WILL BE WRITTEN 
WITH THAT NUMBER OF DECIMAL PLACES, 

FOR EXAMPLE; 2?1 A => 14*00 (REMEMBER THIS IS NOW CHARACTER DATA) 

3tl5 23.35 0.1475 => 15.000 23.350 .148 

NOTICE THAT THE COLUMN'S ARE OF EQUAL WIDTH, SEPARATED BY CHE SPACE, 

IF THE LEFT ARGUMENT IS A VECTOR OF LENGTH TWO, EACH COLUMN IN THE 
RIGHT ARGUMENT WILL TAKE UP THE NUMBER OF SPACES SPECIFIED BY THE 
FIRST ELEMENT OF THE LEFT ARGUMENT, AND EACH ENTRY WILL HAVE THE 
NUMBER OF DECIMAL PLACES SPECIFIED BY THE SECOND ENTRY IN THE 
LEFT ARGUMENT, FOR EXAMPLE; 

IF M => 1.2 3 then 5 It* => 1.2 3.1 

“4 5.55 ‘4.0 5.5 

THE COLUMN ELEMENT MUST BE LARGE ENOUGH TO WRITE THE LONGEST ENTRY, 
INCLUDING ONE SPACE EACH FOR A NEGATIVE SIGN OR DECIMAL POINT, 

IF IT IS HOT, A ‘LENGTH ERROR 1 WILL RESULT, 

REMEMBER TO ALLOW FOR A BLANK BETWEEN COLUMNS; 3 1*1 2 => 1.02.0 

THE LEFT ARGUMENT MAY ALSO BE A VECTOR OF LENGTH EQUAL TO EXACTLY 
TWICE THE NUMBER OF COLUMNS IN THE RIGHT ARGUMENT, 

IN THIS CASE, THE ENTRIES IN THE LEFT ARGUMENT ARE PAIRED AND EACH 
PAIR GOVERNS THE FORMAT OF THE CORRESPONDING COLUMN, AS ABOVE, 

6261 10 0 t 113.524 1 300.24 => 113.52 1.0 300 

ONE FINAL TWIST; IF THE LEFT ARGUMENT IS A NEGATIVE SCALAR, THE 
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RESULT WILL BE WRITTEN IN EXPONENTIAL NOTATION, WITH THE NUMBER 
OF DECIMAL PLACES IN THE MANTISSA EQUAL TO ONE LESS THAN THE 
ABSOLUTE VALUE OF THE LEFT ARGUMENT % 

FOR example: “ i t 3 200 => 3 E 00 2 E 02 

~3t4 ♦ 6167 10*56 400 => 4*62 E 00 1*06 E 01 4*00 E 02 
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FORMAT-MONADIC 



FORM 



ft****************************** t ♦ ♦♦♦♦♦♦♦*♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦» 

THE SYMBOL t (ALT ]) IS USED FOR THE MONADIC FORMAT FUNCTION, 

IT TAKES A NUMERIC OR CHARACTER ARGUMENT OF ANY RANK AND CONVERTS 
IT TO CHARACTER DATA, 

THIS IS USEFUL IN CATENATING NUMERIC VARIABLES TO CHARACTER DATA, 

FOR EXAMPLE; IF 5 :} 3 AND V => ‘GO TO LINE ‘ 

V r 5 WILL PRODUCE A ‘DOMAIN ERROR 1 BUT V 7l S - > GO TO LINE 3 
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D. MAKING MODIFICATIONS 

The variable HOWMODS is included in the TUTOR workspace 
to guide the advanced student, programmer, or instructor who 
wishes to expand, modify, or customize the TUTOR functions 
and variables. Seme suggestions for improvement are 
discussed in chapter 3. Any ideas for modification of TUTOR 
are welcomed — please pass them alcng to Professor R. R. Read 
or the author of this thesis, in care of the Operations 
Analysis curricular office. 
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HOWMODS 



THE FOLLOWING ARE SOME TIPS OH MODIFYING THE TUTOR WORKSPACE; 

TO MODIFY TEXT OF DESCRIPTIVE VARIABLES* 

X EDIT THE VARIABLE (CHECK MAT FOR SHORT NAME) 

BE SURE TO INCLUDE THE APPROPRIATE FIRST COLUMN CONTROL CHARACTERS; 
, FOR GENERAL DESCRIPTION 
o FOR SCALAR DESCRIPTION AND EXAMPLES 
v FOR VECTOR DESCRIPTION AND EXAMPLES 
n FOR MATRIX DESCRIPTION AMD EXAMPLES 

* FOR HIGHER-LEVEL ARRAYS DESCRIPTION AND EXAMPLES 

TO CHANGE THE ORDER OF LESSONS J 

X EDIT MAT TO ASSIGN NEW LESSON NUMBERS, 

THEN, TO REORDER MAT ACCORDING TO LESSON NUMBERS, ENTER; OP.DERMAT 
TO WRITE NEW LESSONS; 

WRITE A NEW TEXT VARIABLE, USING CONTROL CHARACTERS AS ABOVE, 

XEDIT MAT TO ADD A NEW ROW, BE SURE TO INCLUDE; 

COL 1-3 J LESSON NUMBER 

COL 23-31 t NAME OF THE TEXT VARIABLE (LIMIT 4 CHARACTERS) 

COL 35-51 : FULL NAME OF THE LESSON (LIMIT 23 CHARACTERS) 

THE OTHER COLUMNS MAY BE LEFT BLANK AS THEY PERTAIN TO FUNCTION 
SYMBOLS ONLY, 

TO CHANGE OR WRITE NEW QUESTIONS (NOT DRILL); 

XEDIT CUES TO CHANGE OR ADD A QUESTION, BE SURE TO ENCLOSE THE 
TEXT OF THE QUESTION, BUT NOT VARIABLES, IN QUOTE MARKS, 

A CARRIAGE RETURN MAT BE INCLUDED BY USING THE VARIABLE CR , 
ANSWER GROUPS MAY BE SEPARATE VARIABLES SUCH AS AR, RK, 

XEDIT SHOW TO INCLUDE NEW QUESTIONS IN ANY QUESTION VECTOR QV , 

BE SURE TO INCLUDE THE CORRESPONDING ANSWER IN THE VECTOR AV , 
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APPENDIX C 
SAMPLE RUM 



This appendix contains a p 
APL tutor. Sfcudsnt response 
dot or period. (This is a fu 
part of the input.) Other 
indented eight spaces and pre 
At least era example of each c 
TUTOR is included. Also t 
response to questions and dril 



ran tout of a session with the 
to questions is preceded bv a 
nctioa of the terminal and nor 
student input is generally 



ceded 


by several blank lines. 


f 


tha 


various ways to use the 




var 


ious types of student 


Is are 


demonstrated. 
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)LOAD TUTOR- 

SAVED 11:11:15 12/14/33 



YOU MAY USE THE APL TUTOR I N THREE WAYSJ 

(1) ENTER* HELP 

TO SELECT THE SYMBOLS THAT YOU WANT INFORMATION ABOUT, 

(2) enter; teach 

TO SELECT THE SYMBOLS THAT YOU WANT INFORMATION AND DRILL OH, 

(3) enter; menu 

TO SEE A LIST OF SYMBOLS AND TOPICS , 

IF YOU HAVE NEVER USED THE APL TUTOR BEFORE, ENTER; START 

TO SEE THESE INSTRUCTIONS AGAIN AT ANY TIME, ENTER J HOW 



START 



WELCOME TO THE APL TUTOR, 

THE PURPOSE OF THIS WORKSPACE IS TO INTRODUCE YOU TO 

•A PROGRAMMING LANGUAGE' BY DESCRIBING THE FUNCTIONS OF THE 
MANY SPECIAL APL SYMBOLS, AND BY OUTLINING THE PROCEDURES FOR 
DESIGNING YOUR OWN FUNCTIONS, 



THE APL TUTOR ASSUMES YOU HAVE HAD LINEAR ALGEBRA AND T R I G I NOME T R Y , 
CALCULUS IS HOT NECESSARY, 

IF YOU HAVE NEVER HAD ANY COMPUTER PROGRAMMING BEFORE, DON'T WORRY, 
YOU CAN START USING APL RIGHT AWAY, AS A SUPER -SOPHISTICATED 
CALCULATOR WITH MANY BUILT-IN FUNCTIONS, 

IF YOU HAVE STUDIED OTHER COMPUTER PROGRAMMING LANGUAGES, RELAX , 
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APL IS HOT LIKE ANY OF THE OTHER MAJOR HIGH-LEVEL LAHGUAGE5 



YOU CAM FORGET ABOUT BATA TYPES , INPUT/OUTPUT FORMATTING y AND 
MANY OF THE OTHER TEDIOUS DETAILS OF FORTRAN, PASCAL, ETC, 
AFTER YOU ARE SUFFICIENTLY FAMILIAR WITH THE CALCULATOR MODE 
OF APL, YOU CAN LEARN TO DEFINE YOUR OWN FUNCTIONS WITH EASE, 



HERE IS SOME BASIC INFORMATION YOU WILL NEED TO KNOW IN ORDER TO 
UNDERSTAND THE APL TUTOR LESSONS, 

MONADIC AND DYADIC FUNCTIONS 

YOU ARE ALREADY FAMILIAR WITH SYMBOLS WHICH REPRESENT ARITHMETIC 

FUNCTIONS, SUCH AS + OR + , APL USES THESE SYMBOLS AND MANY OTHERS 
TO REPRESENT A VARIETY OF FUNCTIONS, 

MANY FUNCTIONS, SUCH AS + , REQUIRE TWO ARGUMENTS, THAT IS, TWO INPUT 
NUMBERS, IN APL, THESE ARE CALLED DYADIC FUNCTIONS, AND THE SYMBOL 
IS PLACED BETWEEN THE ARGUMENTS} FOR EXAMPLE, 3 + 4, 

OTHER FUNCTIONS, SUCH AS LM (NATURAL LOG), REQUIRE ONLY ONE ARGUMENT, 
THESE MONADIC FUNCTION SYMBOLS ARE PLACED TO THE LEFT OF THE DATA 
WHICH THEY ARE TO OPERATE ON, FOR EXAMPLE, LN 3 IN APL IS 33 , 

DATA TYPES 

APL DISTINGUISHES ONLY TWO TYPES OF DATA 4 , NUMERIC AND CHARACTER, 

VERY SIMPLY, CHARACTER DATA ARE ENCLOSED IN QUOTES (') WHEN ENTERED, 
•2* IS CHARACTER DATA} 2 IS NUMERIC DATA, SOME FUNCTIONS 
WILL OPERATE ON BOTH TYPES OF DATA, SOME ONLY ON NUMERIC, 

ARRAYS 

THE GREATEST STRENGTH OF APL LIES IN ITS ABILITY TO TAKE AN ENTIRE 
ARRAY OF NUMBERS AS A SINGLE ARGUMENT, THUS TWO MATRIXES CAN BE 
ADDED BY ENTERING SIMPLY A+B, WITH NO SUBSCRIPTS, LOOPS, ETC, 

THIS MAKES IT IMPORTANT TO KNOW THE RANK (THE NUMBER OF DIMENSIONS) 

OF DATA IN USE, A SINGLE NUMBER IS NORMALLY A SCALAR (RANK 0)* 

A SERIES OF NUMBERS IS A VECTOR, A ONE-DIMENSIONAL ARRAY (RANK 1), 
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NUMBERS CAN ALSO BE ARRANGED IN ROWS AND COLUMNS, TO MAKE A MATRIX 
(RANK 2)# MATRIXES CAN BE ' STACKED 1 TO MAKE UP THE PAGES OF A 
THREE-DIMENSIONAL ARRAY, OFTEN CALLED A BOOK (RANK 3) 4 IN FACT, 
THERE IS NO LIMIT TO THE NUMBER OF DIMENSIONS IN AN APL ARRAY, 

THE LENGTH OF THE DIMENSIONS IS ALSO EFFECTIVELY UNLIMITED, LENGTH 
REFERS TO THE NUMBER OF ELEMENTS IN A DIMENSION, FOR EXAMPLE, 

THE NUMBER OF ROWS, LENGTH MAY EVEN BE ()♦ 

IN THIS TUTORIAL, A SCALAR MAY BE REFERRED TO AS S, L, OR R, 

A VECTOR MAY BE CALLED V, VI, OR V2, WHILE A MATRIX IS M, Ml, OR M2, 
AN ARRAY, WHICH MAY BE A VECTOR, A MATRIX, OR AN ARRAY OF ANY HIGHER 
DIMENSION, WILL BE LABELLED A, A}, OR A2 , 



EXAMPLES 

WHEN EXAMPLES ARE GIVEN IN THE TEXT OF A FUNCTION DESCRIPTION, THE 

SYMBOL => IS USED BETWEEN THE EXAMPLE INPUT AND THE EXAMPLE OUTPUT, 
FOR example: 2+5 => 7 

THIS SYMBOL CAN BE READ AS ‘PRODUCES' OR 'RETURNS 1 , 



ERRORS 

YOU SHOULD NOT RECEIVE ANY ERROR MESSAGES WHILE USING APL TUTOR, 
HOWEVER, YOU MAY SEE A PHRASE LIKE 'VALUE ERROR' (WITHOUT QUOTE 
MARKS) WHEN YOU ARE EXPECTING A NORMAL RESPONSE, 

Oft IF YOU ACCIDENTALLY HIT THE ENTER KEY WHEN THE COMPUTER IS NOT 
EXPECTING AH INPUT, THE FUNCTION MAY END ABRUPTLY, LIKE THISJ 
MENU [£] 

IF EITHER OF THESE THINGS HAPPEN, BE SURE TO ENTER 4 , -t (UPSHIFT *- ) 
THEN RESTART WITH ANY COMMAND, 

HALTING A LESSON 

YOU MAY STOP ANY LESSON AT ANY POINT WHERE A QUESTION IS ASKED 
BY ENTERING* STOP 

TO SEE THIS INFORMATION AGAIN AT ANY TIME, ENTER*, BASICS 
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YOU MAY START A LESSON IN THREE WAYS * 

d) enter; lesson nextlessqn 

TO START THE LESSON FOLLWING THE LAST ONE YOU COMPLETED, 

( 2 ) ENTER; LESSON NUN (WHERE NUN IS A 3-DIGIT NUMBER) 

TO START LESSON NUMBER NNN, 

TO SEE A LIST OF LESSON NUMBERS, ENTER* MENU 

(3) ENTER* TEACH 

TO SELECT THE SYMBOL THAT YOU WANT A LESSON ON, 

TO SEE THIS INFORMATION AGAIN AT ANY TIME, ENTER; HOWTEACH 



TO START YOUR FIRST LESSON IN AFL, ENTER; LESSON 1Q1 



LESSON 101 



THE SYMBOL ~ (UPSHIFT 2) IS USED ONLY TO ENTER NEGATIVE NUMBERS, 
IT CAN BE USED ONLY IN FRONT OF SCALARS (SINGLE NUMBERS), 

NOT VARIABLE NAMES, ARITHMETIC EXPRESSIONS, OR ARRAYS, 

TO CHANGE ARITHMETIC SIGN USE THE SYMBOL - (UPSHIFT +), 

HOW MANY ARGUMENTS DOES THE NEGATIVE^ NUMBER FUNCTION TAKE? 

*1 

RIGHT 

WHAT RANK CAN THE RIGHT ARGUMENT OF NEGATIVE^ NUMBER BE? 

ENTER S FOR SCALAR 
V FOR VECTOR- 
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X FOR MATRIX 



A FOR ANY RANK 

,5 

RIGHT 



CAN HEGATI VE^NUMBER TAKE CHARACTER ARGUMENTS? 

• N 

RIGHT 

THIS IS THE END OF YOUR LESSON, 

FOR THE NEXT LESSON IN SEQUENCE, ENTER; LESSON NEXTLESSON 
TO START ANOTHER LESSON, ENTER; LESSON NNH 



LESSON NEXTLESSON 

«*«***»****t*«**»**»»**»«*t«t**«4'*«**»««« + tt«*««*»*** + t*«t««« + *«*«* 

THE SYMBOL + IS USED FOR THE MONADIC CONJUGATE FUNCTION, 

THIS IS AN IDENTITY FUNCTION WHICH RETURNS ITS ARGUMENT, AFTER 

EVALUATION IF NECESSARY, IT TAKES NUMERIC ARGUMENTS OF ANY RANK 

HOW MANY ARGUMENTS DOES THE CONJUGATE FUNCTION TAKE? 

, STOP 

THIS LESSON HAS BEEN HALTED, 

TO START ANOTHER LESSON, ENTER; LESSON NHN 
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LESSON IQ? 



THE SYMBOL -j- (UPSHIFT x) IS USED FOR THE DYADIC DIVISION FUNCTION, 
IT PERFORMS SIMPLE DIVISION ON NUMERIC ARGUMENTS OF ANY RANK, 

HOW MANY ARGUMENTS DOES THE DIVIDE FUNCTION TAKE? 

, TWO 

SORRY, PLEASE TRY AGAIN 



HOW MANY ARGUMENTS DOES THE DIVIDE FUNCTION TAKE? 



RIGHT 



WHAT RANK CAN THE LEFT ARGUMENT OF DIVIDE BE? 
ENTER S FOR SCALAR 

V FOR VECTOR 
X FOR MATRIX 

A FOR ANY RANK 

SORRY, PLEASE TRY AGAIN 

WHAT RANK CAN THE LEFT ARGUMENT GF DIVIDE BE? 
ENTER S FOR SCALAR 

V FOR VECTOR 
X FOR. MATRIX 

A FOR. ANY RANK 
♦ A 

RIGHT 

WHAT RANK CAN THE RIGHT ARGUMENT OF DIVIDE BE? 
ENTER S FOR SCALAR 

V FOR VECTOR 
X FOR MATRIX 

A FOR ANY RANK 
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SORRY, PLEASE TRY AGAIN 

WHAT RANK CAN THE RIGHT ARGUMENT OF DIVIDE PE? 



ENTER S FOR 


SCALAR 


V FOR 


VECTOR 


X FOR 


MATRIX 


A FOR 


ANY RANK 


.v 





SORRY, PLEASE TRY AGAIN 

WHAT RANK CAN THE RIGHT ARGUMENT OF DIVIDE BE? 



ENTER 5 FOR 


SCALAR 


V FOR 


VECTOR- 


X FOR 


MATRIX 


A FOR 


ANY RANK 



* '* 

SORRY, THE CORRECT ANSWER IS A 



YOU ENTERED 


5 WRONG ANSWERS OUT OF 3 QUESTIONS, 


IF YOU WANT 


TO RETAKE THIS LESSON, ENTER* LESSON 109 



THIS LESSON 


HAS BEEN HALTED, 



TO START ANOTHER LESSON, ENTER} LESSON NNN 

» 
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HELP 



ENTER THE SYMBOL(S) YOU WOULD LIKE INFORMATION ABOUT, 
OR, , , F 0 R MENU SELECTION, ENTER* MENU 
MENU 



INFORMATION IS AVAILABLE ON 


THE FOLLOWING SYMBOLS/TOP 


ics ; 


101 




N E G A T I V E _ N U M E< E R 


102 


P 


CONJUGATE 


103 


+ 


PLUS 


104 


- 


CHANGE^ SIGN 


105 


- 


MINUS 


106 


X 


SIGNUM 


10? 


X 


TIMES 


108 


P 


RECIPROCAL 


109 


p 


DIVIDE 


121 


( 


PARENS 


122 


i 


QUOTE 


123 


p 


SPECIFICATION 


124 


f 


SHAPE 


125 


f 


RESHAPE 


126 


[ 


BRACKETS 


127 


1 


RAVEL 


128 


J 


CATENATE 


129 


\ 


I N D E X _ G E N ERATO R 


131 


/ 


REDUCTION 


132 


t 


REDUCTION 


141 


* 


EXPONENTIAL 


142 


* 


POWER 


143 


• 


NATURAL_LGG 


144 


3 


LOGARITHM 


145 


O 


PI — TIMES 


146 


O 


GEOMETRIC 


147 


< 

* 


FACTORIAL 


148 


♦ 


BINOMIAL 


149 


I 


MAGNITUDE 


151 


\ 


SCAN 


152 




SCAN 


161 


r 


CEILING 


162 


L 


FLOOR 


163 


r 


MAXIMUM 


164 


L 


MINIMUM 


165 


i 


RESIDUE 


166 


4 


G R A D E _ U P 


167 




GRADE_DOWN 


168 


? 


ROLL 


169 


? 


DEAL 


130 


= 


EQUAL 


131 


F 


NOT^EQUAL 


182 


< 


LESS_THAN 


183 


<_ 


LESS_OR_EGUAL 


134 


l 


GREATER_OR_£CtUAL 


135 


> 


G R E A TE R _ T H A N 


191 


H 


NOT 


192 


A 


AND 


193 


A 


NAND 


194 


V 


OR 


195 


V 


NOR 


196 


€ 


MEMBER OF 


201 


* 


REVERSE 


202 


0 


REVERSE 


203 


<D 


ROTATE 


204 


0 


ROTATE 


205 


S 


TRANSPOSE -MONADIC 


206 


* 


TRANSPOSE- D Y A D I C 


211 


t 


TAKE 


212 




DROP 


213 


/ 


COMPRESS 


214 


/ 


COMPRESS 


215 


\ 


EXPAND 


216 


\ 


EXPAND 


219 


1 


LAMINATE 


231 


a 


M A T R I X _ I N V E R S E 


232 


a 


MATRIX_DI VIDE 


241 


o 


OUTER_PRODUCT 


242 


♦ 


IN NER_PRODUCT 


301 


i 


INDEX_OF 


304 


T 


ENCODE 


305 


X 


DECODE 


306 


i 


EXECUTE 


307 


T 


FORMAT-DYADIC 


308 


t 


FORMAT-MONADIC 


TO 


SEE MENU AGAIN, ENTER * 




MENU 








FOR 


INFORMATION ABOUT 


FUNCTION, ENTER* INFO 


NNH 


(WHERE NNN IS MENU 



UMBER ) 

TO GO THROUGH TUTORIAL LESSON, ENTER* 



LESSON NNN 
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LESS OH 107 



X * * * ♦ ♦ * 

THE SYMBOL X IS USED FOR THE DYADIC TIMES FUNCTION, 

THIS PERFORMS SIMPLE MULTIPLICATION ON NUMERIC ARGUMENTS OF ANY RANK, 

HOW MANY ARGUMENTS DOES THE TIMES FUNCTION TAKE? 

♦ 2 

RIGHT 

WHAT RANK CAN THE LEFT ARGUMENT OF TIMES BE? 

ENTER S FOR SCALAR 

V FOR VECTOR 
X FOR MATRIX 

A FOR ANY RANK 

« 

SORRY y THE CORRECT ANSWER IS A 

WHAT RANK CAM THE RIGHT ARGUMENT OF TIMES BE? 

ENTER S FOR SCALAR 

V FOR VECTOR 
X FOR MATRIX 

A FOR ANY RANK 

, AN Y 
RIGHT 

FOR EXAMPLE; 2X4 = > 3 ORDER AND SPACING ARE NOT IMPORTANT, 

DOES SlxS2 EQUAL S2X =1? 

RIGHT 

WHAT IS THE RESULT OF J 

~20 X 80 
♦ “160 
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\ 



INSTRUCTOR BEFORE RETURNING TO THIS UNIT 



THIS LESSON HAS BEEN HALTED, 

TO START ANOTHER LESSON, ENTER* LESSON NNN 



LESSON 124 

F 

THE SYMBOL p IS USED FOR THE MONADIC SHAPE FUNCTION, 

THIS RETURNS A DESCRIPTION OF THE SICE OF ITS ARGUMENT, WHICH CAN 
BE NUMERIC OR CHARACTER, OF ANY RANK, 

THE SYMBOL CAN BE USED TWICE (ppA) TO RETURN THE RANK OF ITS ARGUMENT, 

HOW MANY ARGUMENTS DOES THE SHAPE FUNCTION TAKE? 

*1 

RIGHT 

WHAT RANK CAN THE RIGHT ARGUMENT OF SHAPE BE? 

ENTER S FOR SCALAR 
V FOR VECTOR 
X FOR MATRIX 
A FOR ANY RANK 
♦ A 

RIGHT 

IF THE ARGUMENT IS A SCALAR, pS RETURNS NO NUMBER (AN EMPTY VECTOR), 
BECAUSE A SCALAR HAS NO DIMENSION, ppS => Q 
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ENTERING fV RETURNS ONE NUMBER WHICH REPRESENTS 
THE VECTOR'S ONE DIMENSION, ffV => 1 



THE LENGTH OF 



WHAT IS THE RESULT OF; 

t 10 20 90 ~40 

♦ M 

SORRY, THIS ANSWER NOT ACCEPTABLE, PLEASE ENTER A NUMERIC ANSWER, 



WHAT IS THE RESULT OF; 

f 10 20 90 ~40 

CORRECT * 

WHAT IS THE RESULT OF; 

f 2 0 3 
♦ 3 

CORRECT { 

THE SHAPE OF MATRIXES IS EXPRESSED AS A TWO-ELEMENT VECTOR, 

THE FIRST ELEMENT EQUALS THE NUMBER OF ROWS (THE LENGTH OF THE 
FIRST DIMENSION), AND THE SECOND ELEMENT EQUALS THE NUMBER OF 
COLUMNS (THE LENGTH OF THE SECOND DIMENSION), 

for example; if m = > i 2 3 them fM => 2 3 and ffM = > 2 

4 5 6 



FOR HIGHER-LEVEL ARRAYS, fA WILL BE A VECTOR WITH AS MANY ELEMENTS AS 
A HAS DIMENSIONS, THE HUMBER OF COLUMNS WILL ALWAYS BE THE LAST 
ELEMENT OF fA, THE HUMBER OF ROWS WILL ALWAYS BE THE NEXT-TO-LAST 
ELEMENT, PRECEDED BY THE HUMBER OF 'PAGES' OR PLANES, PRECEDED BY 
THE NUMBER OF 'BOOKS' OR SPACES, AND 50 ON, 

FOR EXAMPLE} IF D IS A 4-DIMENSIONAL ARRAY, ffD => 4 , 

IF fD => 5342 THEN D HAS 5 BOOKS, EACH WITH 3 PAGES, EACH OF 
WHICH HAS 4 ROWS AND 2 COLUMNS, (THIS WOULD BE DISPLAYED AS 
FIFTEEN SUCCESSIVE 4x2 MATRIXES — THE FIRST THREE BEING THE FIRST 



180 



BOOK, THE SECOND THREE BEING THE SECOND BOOK, ETC,) 

CAN SHAPE TAKE CHARACTER ARGUMENTS? 

RIGHT 

IF SO, WHICH ARGUMENT ( S ) CAN BE CHARACTER? 

ENTER R FOR RIGHT, 

L FOR LEFT, OR 
& FOR BOTH 

RIGHT 

THIS IS THE END OF Y OUR LESSON, 

FOR THE NEXT LESSON IN SEQUENCE, ENTER • LESSON NEXTLE350N 
TO START ANOTHER LESSON, ENTER; LESSON NMN 



LESSON MEXTLESSON 

******************************* F *********************************** 
THE SYMBOL f IS USED FOR THE DYADIC RESHAPE FUNCTION, 

THIS TAKES THE ELEMENTS OF THE RIGHT ARGUMENT AND REARRANGES THEM 
ACCORDING TO THE SHAPE SPECIFIED BY THE LEFT ARGUMENT, 

THE LEFT ARGUMENT MUST BE AN INTEGER SCALAR OR A VECTOR OF INTEGER 
ELEMENTS , 

THE RIGHT ARGUMENT CAN BE NUMERIC OR CHARACTER, OF ANY RANK, 

HOW MANY ARGUMENTS DOES THE RESHAPE FUNCTION TAKE? 

♦ 2 

RIGHT 
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WHAT RANK CAM THE LEFT ARGUMENT OF RESHAPE BE? 

E t-l T E R S FOR SCALAR 

V FOR VECTOR 
X FOR MATRIX 

A FOR AMT RANK 
*V 

RIGHT 

WHAT RANK CAN THE RIGHT ARGUMENT OF RESHAPE BE? 

ENTER 5 FOR SCALAR 

V FOR VECTOR 
X FOR MATRIX 

A FOR ANY RANK 

RIGHT 

IF THE LEFT ARGUMENT IS A SCALAR, THE RESULT WILL BE A VECTOR WITH 

LENGTH EQUAL TO THE SCALAR, CONSISTING OF THE ELEMENTS OF THE RIGHT 
ARGUMENT, TAKEN IN ORDER TOP LEFT TO BOTTOM RIGHT t 
WHEN THERE ARE NOT ENOUGH ELEMENTS IN THE RIGHT ARGUMENT, 

THE FUNCTION WILL START OVER AND TAKE THE ELEMENTS IN ORDER AGAIN, 
AS MANY TIMES AS NECESSARY TO FILL THE VECTOR , 

FOR EXAMPLE* 4fl => 1 1 1 1 

( 1 AB 1 ) r> ABAB 

IF THERE ARE TOO MANY ELEMENTS ON THE RIGHT, THE EXTRAS ARE OMITTED, 
FOR EXAMPLE* 2f ( 1 2 3 4) => 1 2 

DOES SlfS2 EQUAL S2/>S1? 

.N 

RIGHT 

WHAT IS THE RESULT OF ♦ 

2 t 0,6 
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CORRECT ANSWER IS* 



. *6 

5 0 F: ft Y j 

0,6 0,6 

WHAT IS THE RESULT OF ; 

2 f 0.1 

. .1 .1 .1 

SORRY, CORRECT ANSWER IS; 

0.1 0.1 

WHAT IS THE RESULT OF; 

3 f 0.6 
, , 6 *6 ,6 
CORRECT ; 

IF THE LEFT ARGUMENT IS A VECTOR, THE ELEMENTS INDICATE, IN ORDER, 

LENGTH OF EACH DIMENSION IN THE RESULT, 

for example; 2 2/1 2 3 4 => 12 

3 4 

THIS IS ONE WAY TO ENTER MATRIXES OR ARRAYS OF HIGHER DIMENSION, 

IF ONE ARGUMENT IS A VECTOR, THE OTHER ARGUMENT MAY BE SCALAR OR VECTOR, 
(T/F) 

.T 

RIGHT 

WHAT IS THE RESULT OF; 

3 f 0.1 4 
..1 4 .1 
correct; 

USING A MATRIX OR HIGHER-LEVEL ARRAY AS THE LEFT ARGUMENT OF RESHAPE 
WILL RESULT IN A 'RANK ERROR', 

IF ONE ARGUMENT IS A MATRIX, THE OTHER ARGUMENT MUST BE A SCALAR 
OR A MATRIX OF THE SAME SHAPE, (T/F) 
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RIGHT 



CAN RESHAPE TAKE CHARACTER ARGUMENTS? 

• Y 

RIGHT 

IF 50, WHICH ARGUMENT ( 5 ) CAM BE CHARACTER? 

ENTER R FOR RIGHT, 

L FOR LEFT, OR 
B FOR BOTH 

• R 

RIGHT 

THIS IS THE END OF YOUR LESSON, 

FOR THE NEXT LESSON IN SEQUENCE, ENTER ♦ LESSON NENTLE550N 
TO START ANOTHER LESSON, ENTER; LESSON NNN 
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TEACH 



ENTER THE SYMBOL(S) YOU WOULD LIKE INFORMATION ABOUT, 
OR FOR MENU SELECTION, ENTER} MENU 

♦ + 



+ ♦ 

THE SYMBOL + IS USED FOR THE MONADIC CONJUGATE FUNCTION, 

THIS IS AN IDENTITY FUNCTION WHICH RETURNS ITS ARGUMENT, AFTER- 

EVALUATION IF NECESSARY, IT TAKES NUMERIC ARGUMENTS OF ANY RANK, 

HOW MANY ARGUMENTS DOES THE CONJUGATE FUNCTION TAKE? 

♦ 1 

RIGHT 

WHAT RANK CAM THE RIGHT ARGUMENT OF CONJUGATE BE? 

ENTER S FOR SCALAR. 

V FOR VECTOR 
X FOR MATRIX 
A FOR ANY RANK 

.A 

RIGHT 

EXAMPLE} +2 => 2 +“3 + 2 => ” 1 ♦ 



CAN CONJUGATE TAKE CHARACTER ARGUMENTS? 

.H 

RIGHT 



******************************* t *********************************** 
THE SYMBOL + IS USED FOR THE DYADIC PLUS FUNCTION , 
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THIS PERFORMS SIMPLE ADDITION ON NUMERIC ARGUMENTS OF ANY RANK, 



HOW MANY ARGUMENTS DOES THE PLUS FUNCTION TAKE? 



RIGHT 



WHAT RANK 
ENTER S FOR 
7 FOR 
X FOR 
A FOR 



THE LEFT 
SCALAR 
VECTOR 
MATRIX 
ANY RANK 



CAN 



ARGUMENT 



OF PLUS BE? 



, A 

RIGHT 



WHAT RANK CAN THE RIGHT ARGUMENT OF PLUS BE? 

ENTER 5 FOR SCALAR 
V FOR VECTOR 
X FOR MATRIX 
A FOR ANY RANK 

♦ A 

RIGHT 

for example; 2 + 2 = > 4 spacing is not important, 

DOES S1+S2 EQUAL S2+S1? 

RIGHT 

WHAT IS THE RESULT OF; 

10 + 10 

♦ + 

SORRY, THIS ANSWER NOT ACCEPTABLE, PLEASE ENTER A NUMERIC ANSWER, 
WHAT IS THE RESULT OF* 
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io + 10 

♦ 20 

CORRECT J 



TO ADD A SCALAR TO EACH ELEMENT OF A VECTOR, ENTER EITHER S+V OR V + S, 
V1+V2 WILL ADD TWO VECTORS ELEMENT BY ELEMENT, FOR EXAMPLE* 

2+ ( 3 4 5) => 5 6 7 (34 5)+2 => 567 

(3 4 5> + (5 6 7) = > 8 10 12 

IF THE TWO VECTORS BEING ADDED ARE NOT THE SAME LENGTH, 

YOU WILL GET A 'LENGTH ERROR', 

IF ONE ARGUMENT IS A VECTOR, THE OTHER ARGUMENT MAY BE SCALAR OR VECTG 
(T/F) 

*T 

RIGHT 

WHAT IS THE RESULT OF* 

0.2 + 0.9 0.3 

* * 2 . *9 » a 

SORRY, THIS ANSWER MOT ACCEPTABLE, PLEASE ENTER A NUMERIC ANSWER, 

WHAT IS THE RESULT OF* 

0.2 + 0.9 0.3 

.1.1 .5 

CORRECT J 

WHAT IS THE RESULT OF* 

"5 4 3 + “5 

, STOP 

THIS LESSON HAS BEEN HALTEB, 

THIS IS THE END OF SCHEDULED LESSONS, 

TO SELECT MORE LESSONS, ENTER} TEACH 
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TEACH 



ENTER THE SYMBOL(S) YOU WOULD LIKE INFORMATION ABOUT, 

OR FOR MENU SELECTION, ENTER* MENU 

,MENU 

INFORMATION IS AVAILABLE ON THE FOLLOWING SYMBOLS/ TOP I CS ♦ 
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NEGATIVE_NUMBER 


102 


+ 


CONJUGATE 


103 


-i. 


PLUS 


104 




CHANGERS IGN 


105 


- 


MINUS 


106 


X 


SIGMUM 


107 


X 


TIMES 


108 


T 


RECIPROCAL 


10? 


T 


DIVIDE 


121 


( 


PARENS 


122 


1 


QUOTE 


123 


f 


SPECIFICATION 


124 


f 


SHARE 


125 


f 


RESHAPE 


126 


C 


BRACKETS 


127 


f 


RAVEL 


128 


r 


CATENATE 


129 


l 


IN D E X _ G E NE R A T O R 


131 


/ 


REDUCTION 


132 


/ 


REDUCTION 


141 


A 


EXPONENTIAL 


142 


* 


ROWER 


143 


& 


N A T U R A L _ L O G 


144 


<S 


LOGARITHM 


145 


0 


PI_TIMES 


146 


O 


GEOMETRIC 


147 


i 

♦ 


FACTORIAL 


148 


1 

* 


BINOMIAL 


149 


I 


MAGNITUDE 


151 


\ 


SCAN 


152 


\ 


SCAN 


161 


r 


CEILING 


162 


L 


FLOOR 


163 


r 


MAXIMUM 


164 


L 


MINIMUM 


165 


1 


RESIDUE 


166 


6 


GRADE_UR 


167 




G R A D E _ D O W N 


168 


? 


ROLL 


16? 


? 


DEAL 


180 


= 


EQUAL 
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NGT_EGUAL 


182 


< 


LESS_THAN 


183 


i 


LESS_OR_EGUAL 


184 


l 


GREATER_OR_£GUAL 
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) 


GREATER_THAN 


191 


H 


NOT 


192 


A 


AND 


193 


A 


HAND 


194 


V 


OR 


195 


V 


NOR 


196 




MEMBER OF 


201 


0) 


REVERSE 


202 


e 


REVERSE 


203 


♦ 


ROTATE 


204 


0 


ROTATE 


205 


* 


TRANSPOSE -MONADIC 


206 


* 1 


TRANSPOSE-DYADIC 


211 


t 


TAKE 


212 


V 


DROP 


213 


/ 


COMPRESS 


214 


/ 


COMPRESS 


215 


\ 


EXPAND 


216 


\ 


EXPAND 


219 


1 


LAMINATE 


231 


a 


MATRIX^INVERSE 


232 


e 


MATRIX^ DIVIDE 


241 


o 


OUTER_PRQDUCT 


242 


* 


I HNER — PRODUCT 


301 


i 


INDEX_QF 


304 


T 


ENCODE 


305 


J. 


DECODE 


306 


i 


EXECUTE 


307 


* 


FORMAT-DYADIC 


308 


T 


FORMAT-MONADIC 


TO 


SEE MENU AGAIN, ENTER* 




MENU 








FOR 


INFORMATION ABOUT 


FUNC7 


ION, ENTER* INFO 


NHN 


(WHERE NNN IS MENU N 



UMBER) 

TO GO THROUGH TUTORIAL LESSON, ENTER* LESSON NNM 
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LESSON 105 



THE SYMBOL - (UPSHIFT +) IS USED FOR THE DYADIC MINUS FUNCTION* 
IT PERFORMS SIMPLE SUBTRACTION ON NUMERIC ARGUMENTS OF ANY RANK 

HOW MANY ARGUMENTS DOES THE MINUS FUNCTION TAKE? 

♦ 2 

RIGHT 

WHAT RANK CAN THE LEFT ARGUMENT OF MINUS BE? 

ENTER 5 FOR SCALAR 

V FOR VECTOR 
X FOR MATRIX 

A FOR ANY RANK 

♦ A 

RIGHT 

WHAT RANK CAN THE RIGHT ARGUMENT OF MINUS BE? 

ENTER S FOR SCALAR 

V FOR VECTOR 
X FOR MATRIX 

A FOR ANY RANK 

♦ A 

RIGHT 

FOR example; 5-2 = > 3 ~10-~2 => '3 

DOES 5 1 -S 2 EQUAL *2-51? 

.H 

RIGHT 

WHAT IS THE RESULT OF J 

0*1 - '0*3 

*•4 
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CORRECT I 



TO SUBTRACT A SCALAR FROM EACH ELEMENT OF A VECTOR, ENTER V-S, 

TO SUBTRACT EACH ELEMENT OF A VECTOR FROM THE SAME SCALAR, ENTER 5-V , 

VI -V2 WILL SUBTRACT EACH ELEMENT OF V2 FROM THE CORRESPONDING 
ELEMENT OF VI, 

VI AND V2 MUST BE THE SAME LENGTH OR YOU WILL GET A 'LENGTH ERROR*, 

FOR example j (3 4 5>-2 => 123 2-<3 4 5) = > ”1 *2 ”3 

(6 7 8 ) - ( 1 23) => 555 

IF ONE ARGUMENT IS A VECTOR, THE OTHER ARGUMENT MAY BE SCALAR OR VECTOR, 
(T/F) 

♦ T 

RIGHT 

WHAT IS THE RESULT OF { 

0 ♦ ? - 0.6 0.5 

..3 .4 

CORRECT J 

WHAT IS THE RESULT OF • 

1 2 3 - ”5 

. "4 ’3 "2 

SORRY, CORRECT ANSWER IS* 

6 7 8 

WHAT IS THE RESULT OF*, 

"0.9 0.4 - “0.4 
.“.5 .8 

CORRECT l 

WHAT IS THE RESULT OF; 

“0.7 0.8 - “0.8 0.7 
..1 1.5 

SORRY, CORRECT ANSWER IS*, 
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0*1 0*1 

WHAT IS THE RESULT OF: 



30 “60 50 “30 - 90 30 “10 “50 

*“10 “90 60 “30 

CORRECT J 



ENTER M-S TO SUBTRACT THE SCALAR S FROM EACH ELEMENT OF THE MATRI 
ENTER S-M TO DO THE OPPOSITE, 

FOR EXAMPLE? IF M => 12 THEN 4 -H = > 3 O AND *-2 =>“10 

3 4 10 12 

M1-M2 SUBTRACTS MATRIX M2 FROM MATRIX M 1 ? ELEMENT BY ELEMENT , 

FOR EXAMPLE; IF Ml = > 1 2 AMD M2 =>3 4 THEN M 2 - M 1 = > 2 2 

3 4 5 6 2 2 

IF Ml AND M2 ARE NOT THE SAME SHAPE , A 'LENGTH ERROR' WILL RESULT 

TRYING TO SUBTRACT A VECTOR FROM A MATRIX OR VICE-VERSA WILL 
PRODUCE A 'RANK ERROR', 

IF ONE ARGUMENT IS A MATRIX, THE OTHER ARGUMENT MUST BE A SCALAR 
OR A MATRIX OF THE SAME SHAPE, (T/F) 

*T 

RIGHT 

THESE PRINCIPLES CAN BE EXTENDED TO HIGHER LEVEL ARRAYS, 

CAN MINUS TAKE CHARACTER ARGUMENTS? 

*H 

RIGHT 

WRITE A TRUE STATEMENT USING -, 

for example; 4=2+2 
♦ 2 - 2=0 

SORRY, THIS STATEMENT IS NOT TRUE, 

TRY AGAIN, 
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WRITE A TRUE STATEMENT USING 



FOR EXAMPLE ♦ 4=2^2 

♦ 4 = 2 + 2 

YOUR ANSWER DOES NOT USE -, TRY AGAIN, 

WRITE A TRUE STATEMENT USING -, 

for example: 4=2+2 
♦<2-2>=4 

DO YOU WISH TO REVIEW THE DESCRIPTION OF MINUS? 
ENTER Y OR N , 

.X 



WRITE A TRUE STATEMENT USING -, 

FOR EXAMPLE { 4=2+2 

♦ 0 = 2-2 
CORRECT J 

THIS IS THE END OF YOUR LESSON, 

FOR THE NEXT LESSON IN SEQUENCE f ENTER ♦ LESSON NEXTLESSON 
TO START ANOTHER LESSON, ENTER J LESSON NNH 
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HELP 



ENTER THE SYMBQL(S) YOU WOULD LIKE INFORMATION ABOUT , 
OR,, , FOR MENU SELECTION , ENTER J MENU 

♦ \ 



♦ ♦»«»»»»»»•♦«*♦*•»»»»♦»»*»»»»** \ «»» t »»»«» t « t t » t t » t » t t t »»*»»»* t M 

THE SYMBOL \ (UPSHIFT I) IS USED FOR THE MONADIC INDEX GENERATING 
FUNCTION , 

IT IS USED WITH A SINGLE NON-NEGATIVE INTEGER ARGUMENT (SCALAR, OR 
VECTOR OF LENGTH 1), 

IT RETURNS A VECTOR OF INTEGERS , IN ORDER, BEGINNING WITH THE INDEX 
ORIGIN, AND ENDING WITH THE ARGUMENT, 

FOR EXAMPLE* \3 => 1 2 3 \0 => (AN EMPTY VECTOR) 

THE INDEX ORIGIN IS NORMALLY (BY DEFAULT) 1, 

USING \ WITH A NON-INTEGER, NEGATIVE OR ARRAY ARGUMENT WILL PRODUCE A 
‘DOMAIN ERROR 1 , 



• \ »»»»»«*»*•»«»**»»«**»♦»»«»»»»»*«*♦* 
THE SYMBOL \ (UPSHIFT I) IS USED FOR THE DYADIC INDEX OF FUNCTION , 

THE LEFT ARGUMENT MUST BE A VECTOR AND THE RIGHT ARGUMENT CAN BE 
ANY RANK, INDEX OF CAN BE USED WITH CHARACTER OR NUMERIC DATA, 

IT RETURNS THE POSITION IN THE LEFT ARGUMENT OF THE ELEMENTS OF THE 
RIGHT ARGUMENT, THE SHAPE OF THE RESULT IS THE SAME AS THE 
SHAPE OF THE RIGHT ARGUMENT, 

IF THE RIGHT ARGUMENT DOES NOT OCCUR IN THE LEFT ARGUMENT, THE RESULT 
WILL BE ONE PLUS THE LENGTH OF THE LEFT ARGUMENT, 



FOR EXAMPLE* 


4 3 2 1 \ 3 => 


o 

£- 


BECAUSE 


3 


IS 


IN THE SECOND POSITION 




1 HELLO 1 \ 1 P ' = > 


6 


BECAUSE 


p 


15 


NOT FOUND 



MORE? 
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V\A CHECKS EACH ELEMENT OF THE RIGHT ARGUMENT INDIVIDUALLY, 

FOR example j 3579\12345 => 55152 

IF YOU ASSIGN ALPHABET f- 1 ABCDEFGHI J K LMHOPQRSTUVWXYZ ' 

THEN ALPHABET \ ' APL ' = > 1 1 £ 12 



FOR MORE HELP, ENTER J HELP 
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MENU 



INFORMATION IS AVAILABLE 


: on 


THE FOLLOWING S*l 


MB0LS/TQPIC5 J 


101 


- 


NEGATIVE. NUMBER 


102 


+ 


CONJUGATE 


103 


+ 


PLUS 


104 


- 


C H A N G E _ S I 6 N 


105 


- 


MINUS 


106 


X 


SIGMUM 


107 


X 


TIMES 


108 


T 


RECIPROCAL 


109 


T 


DIVIDE 


121 


( 


PARENS 


122 


1 


QUOTE 


123 




SPECIFICATION 


124 


f 


SHAPE 


125 


f 


RESHAPE 


126 


[ 


BRACKETS 


127 




RAVEL 


123 




CATENATE 


129 


\ 


INDEX. GENERATOR 


131 


/ 


REDUCTION 


132 


/ 


REDUCTION 


141 


* 


EXPONENTIAL 


142 


* 


POWER 


143 


<a 


NATURAL.LOG 


144 


• 


LOGARITHM 


145 


0 


PI. TIMES 


146 


O 


GEOMETRIC 


147 


i 

♦ 


FACTORIAL 


148 


1 

♦ 


BINOMIAL 


149 


1 


MAGNITUDE 


151 


\ 


SCAN 


152 


\ 


SCAN 


161 


r 


CEILING 


162 


L 


FLOOR 


163 


r 


MAXIMUM 


164 


L 


MINIMUM 


165 


i 


RESIDUE 


166 


4 


G R A D E _ U P 


167 


T 


GRADE. DOWN 


163 


? 


ROLL 


169 


? 


DEAL 


180 


= 


EQUAL 


181 


* 


NOT. EQUAL 


182 


< 


LESS. THAN 


183 


/ 


LESS. OR. EQUAL 


184 


> 


GREATER. OR. EQUAL 


185 


> 


GREATER _T HAN 


191 


N 


NGT 


192 


A 


AND 


193 


A 


HAND 


194 


V 


OR 


195 


V 


NOR 


196 


€ 


MEMBER OF 


201 


0 


REVERSE 


202 


9 


REVERSE 


203 


* 


ROTATE 


204 


9 


ROTATE 


205 


$ 


TRANS POSE -MONADIC 


206 


* 


TRANSPOSE-DYADIC 


211 


t 


TAKE 


212 


* 


DROP 


213 


/ 


COMPRESS 


214 


/ 


COMPRESS 


215 


\ 


EXPAND 


216 


\ 


EXPAND 


219 


J 


LAMINATE 


231 


0 


MATRIX. INVERSE 


232 


0 


MATRIX. DIVIDE 


241 


o 


OUTER. PRODUCT 


242 


♦ 


INNER. PRODUCT 


301 


\ 


INDEX. OF 


304 


T 


ENCODE 


305 


X 


DECODE 


306 


t 


EXECUTE 


307 


T 


FORMAT-DYADIC 


308 


T 


FORMAT-MONADIC 



TO SEE MENU AGAIN, ENTER; MENU 

FOR INFORMATION ABOUT FUNCTION, ENTER; INFO NNN (WHERE NNN IS MENU N 
UMBER ) 

TO GO THROUGH TUTORIAL LESSON, ENTER J LESSON NNN 
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INFO 180 



THE SYMBOL = (UPSHIFT 5) IS USED FOR THE DYADIC EQUALS FUNCTION, 

THIS COMPARES NUMERIC OR CHARACTER ARGUMENTS OF ANY RANK, 

IT RETURNS 1 FOR EACH ELEMENT OF THE LEFT ARGUMENT THAT IS IDENTICAL 
TO THE CORRESPONDING ELEMENT OF THE RIGHT ARGUMENT , AND Q FDR 
EACH ELEMENT THAT IS NOT , 

FOR EXAMPLE* 2 = 2 => 1 2 = 4 => 0 'A's'B' = > Q 

MORE? 

.N 

FOR MORE INFORMATION, ENTER* INFO NNN 
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TEST 211 

WHAT IS THE RESULT OF * 

"3 i "30 40 60 "90 

.40 60 "90 

CORRECT ‘ 

TEST OK 
* 

TEST 203 

WHAT IS THE RESULT OF * 

“1 $ 60 70 "20 "40 

♦ 

SORRY, CORRECT ANSWER IS* 

“40 60 70 "20 

WHAT IS THE RESULT OF* 

2 4) 0 "60 "40 "10 

♦ "40 "10 0 "60 

CORRECT { 

TEST OK 
* 

test 152 

WHAT IS THE RESULT OFJ 

T\ 7 "6 "1 
.7 7 7 

CORRECT J 
TEST OK 
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TEST U6 



WHAT IS THE RESULT OF* 

$ ”0.3 “0.4 

.2 1 

CORRECT J 



WHAT IS THE RESULT OF; 

* 3 5 "6 

, STOP 



THIS TEST HAS SEEM HALTEI', 



STOP 

IF YOU WANT TO EHI> THIS SESSION, ENTER* )SAVE 

WHEN YOU SEE THE TIME, DATE, AND 'TUTOR 1 MESSAGE, ENTER* 

. ) SAVE 

11J42:19 12/14/83 tutor 

, ) OFF 

CONNECT® 0U10:27 VIRTCPU= 000:02.38 TOTCPU® 000J11.11 
CONNECT = $5.37 T0TCF‘U= $1.85 310= $0.41 T0TAL= $3.1 

MULT BY SHIFT FACTOR: =1<DAY), =0.6(EVE)» =0.3(NIGHTS) 
LOGOFF AT 11:42542 PST WEDNESDAY 12/14/S3 

VM/370 ONLINE 



) OFF 



3 
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